Skip to main content

WhatsApp Connector

This guide explains how to create and configure a WhatsApp connector in Yggio. Currently, only the Twilio provider is supported.

Overview​

  • WhatsApp connectors enable sending WhatsApp messages via rule actions.
  • You must have a Twilio account with WhatsApp messaging enabled.
  • Required fields are validated in the UI.
  • You can optionally specify a backup email address for failed WhatsApp delivery (if an email connector exists).

Twilio Setup Requirements​

To use WhatsApp with Twilio, you must complete the following steps:

  1. Sign up for a Twilio account and verify your email and phone number: https://www.twilio.com/try-twilio
  2. Request WhatsApp access in the Twilio Console (WhatsApp > Senders > Request Access).
  3. Register your business and WhatsApp-enabled phone number with Twilio.
  4. Wait for Twilio approval and number activation (this process may take several days).
  5. Set up a WhatsApp sender (your approved number) in the Twilio Console.
  6. Get your Account SID and Auth Token from the Twilio Console dashboard.
  7. Use the approved sender number as the “From” field in your connector configuration.
  8. (Optional for testing) Use Twilio’s WhatsApp Sandbox to send test messages before your number is fully approved.

For detailed instructions, see the Twilio WhatsApp Quickstart.

Creating a WhatsApp Connector​

  1. Go to the Connectors section in the Control Panel (/control-panel-v2/connectors).
  2. Click Add Connector and select WhatsApp as the type.
  3. Choose Twilio as the service provider.
  4. Fill in the required fields:
  • Account SID: Your Twilio Account SID (must start with AC).
  • Auth Token: Your Twilio Auth Token (kept secret).
  • From: The sender number (must be in E.164 format, e.g., +1234567890).
  • To: The recipient number(s) (must be in E.164 format).
  1. (Optional) For each recipient, you can specify a backup email address. If WhatsApp delivery fails, the message will be sent via email (requires an email connector).
  2. Save the connector.

Field Details​

FieldDescriptionRequiredValidation
Account SIDTwilio Account SID (starts with AC)YesMust start with AC
Auth TokenTwilio Auth Token (secret)YesNon-empty
FromSender number (E.164 format)YesMust be valid E.164
ToRecipient number(s) (E.164 format)YesMust be valid E.164
Backup EmailEmail address for fallback (optional)NoMust be valid email

Example​

  1. Account SID: ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  2. Auth Token: your_auth_token
  3. From: +46700000000
  4. To: +46710000001
  5. Backup Email: user@example.com (optional)

Notes​

  • Only Twilio is supported as a WhatsApp provider at this time.
  • All numbers must be in E.164 format (e.g., +1234567890).
  • You can add multiple recipients, each with an optional backup email.
  • You must have a valid Twilio account with WhatsApp enabled.

Screenshots​

WhatsApp Connector

Messaging Statistics​

On the saved connector page, you will see a statistics panel showing:

  • Total Sent: Number of messages successfully sent.
  • Total Fails: Number of failed send attempts.
  • Sent This Month: Number of messages sent in the current month.
  • Success Rate: Percentage of successful deliveries.
  • Attempts: Total number of send attempts (successes + failures).
  • Last Sent: Timestamp of the most recent successful send.
  • Last Failed: Timestamp of the most recent failed send.
  • Last Error: The latest error or warning message, if any, with timestamp.

Messaging Statistics Panel

These statistics help you monitor the health and performance of your connector.

Error Logging​

If the connector fails to send a WhatsApp message, an error log will be displayed in Logs under Resource → Connector. You can review these logs to diagnose and resolve issues with your connector configuration or Twilio account.

Error Logs