Connect your messaging channels

WhatsApp uses a number that you connect to your workspace. SMS does not need a paired channel.

Pair a WhatsApp number

  1. Open Channels and create a channel with a recognizable display name.
  2. Start the connection and choose QR code or phone pairing.
  3. In WhatsApp on your phone, open Linked devices. Scan the QR code, or choose the phone-number linking option and enter the pairing code.
  4. Wait for Ziph to show the channel as Connected.

QR codes expire. Use the current code shown by the dashboard. If pairing fails, restart the connection and try again.

Your trial or plan limits how many WhatsApp numbers the workspace can have. See Billing for allowance behavior and Pricing for plan capacity.

Choose a sending number

One WhatsApp channel can be the workspace default. A message without channel_id uses that channel. To choose another connected channel, include its ID:

{
  "channel_type": "whatsapp",
  "channel_id": "YOUR_CHANNEL_ID",
  "to": "+23276123456",
  "text": "Your order is ready."
}

The channel must belong to your workspace. Manage and reconnect numbers in the dashboard’s Channels page. Use the API Reference for the message’s channel_id field.

Handle disconnections

StatusWhat to do
connectedThe connection is ready for sending.
connectingWait for the connection attempt to finish.
needs_pairPair the number with your phone again.
disconnectedTry reconnecting; pair again if requested.
unknownInspect the channel before attempting a send.

Deleting a channel disconnects it and permanently deletes its webhook configuration. Existing message history is retained.

Send SMS

SMS uses a separate segment allowance, not your WhatsApp plan. New workspaces start with zero SMS segments; contact support to arrange an allowance.

{
  "channel_type": "sms",
  "to": "+23276123456",
  "text": "Your verification code is 482913."
}

Do not include channel_id for SMS. Images, buttons, and lists are WhatsApp-only.

Long texts and some characters require multiple SMS segments. See Billing for how messages count toward your allowance. SMS delivery receipts are not currently available.