REST API Reference & Operator Manual

Fizmoh Cloud provides a multi-tenant API. Every request made with a tenant API key automatically operates within that tenant's isolated database scope.

Generate your secret API key in Settings → API Keys & Docs. Keys begin with the prefix fiz_live_....

Pass your API key in either of the following HTTP headers:

X-API-Key: fiz_live_your_secret_key_here
# or
Authorization: Bearer fiz_live_your_secret_key_here

1. Send WhatsApp Message (cURL)

curl -sS -X POST https://app.fizmoh.cloud/api/external/v1/whatsapp/send \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: fiz_live_REPLACE_ME' \
  -d '{
    "phone": "+96898821965",
    "type": "text",
    "text": "Your booking ORD-9821 is confirmed! View details: https://app.fizmoh.cloud"
  }'

2. Node.js Example

const res = await fetch("https://app.fizmoh.cloud/api/external/v1/whatsapp/send", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.FIZMOH_API_KEY,
  },
  body: JSON.stringify({
    phone: "+96898821965",
    text: "Welcome to Fizmoh Cloud!",
  }),
});
const data = await res.json();
console.log("Message ID:", data.messageId);

Connect your online store directly to WhatsApp to automate high-intent conversational workflows: recover abandoned shopping carts with 1-click restoration links, send interactive order confirmations with tracking buttons, and capture compliant WhatsApp newsletter subscribers.

WooCommerce Setup Instructions

1. Download the plugin package above or navigate to Settings → E-Commerce & Stores in your Fizmoh dashboard.
2. In WordPress, navigate to Plugins → Add New → Upload Plugin and upload fizmoh-connect-for-woocommerce.zip.
3. Activate the plugin, then go to WooCommerce → Fizmoh Connect Settings.
4. In Fizmoh, under Settings → E-Commerce & Stores → Connected Stores, click Add Store Connection to generate your unique Store Key.
5. Paste the Store Key into the WordPress settings page and click Test Connection.

Default Interactive WhatsApp Templates with Action Buttons

Fizmoh dispatches high-converting interactive templates out of the box. Merchants can also map custom Meta-approved templates in the dashboard:

Shopify Webhook Configuration

For Shopify stores, configure your webhooks pointing to https://app.fizmoh.cloud/api/ecommerce/webhooks/shopify. In your Fizmoh dashboard, paste your Shopify Shared Secret to verify HMAC-SHA256 signatures (X-Shopify-Hmac-Sha256) automatically.

Subscribe your backend systems to real-time events triggered by customer interactions, incoming messages, and payments.

• message.received — Inbound WhatsApp message received from a customer.
• message.delivered — Message delivery receipt confirmation.
• order.created — Customer created an order / booking.
• order.paid — Verified AmwalPay payment received.