Skip to content

Europe · Europe and global

Bird WhatsApp API setup for Ultra WhatsApp

Bird, formerly MessageBird. Uses Bird's current WhatsApp API, not the legacy Conversations API.

What Ultra WhatsApp asks for

Values to copy from Bird
API keybird.com dashboard, API keys. It starts with bk_us1_ or bk_eu1_ and needs the whatsapp scope. The API region comes from this prefix.
WhatsApp sender numberThe WhatsApp sender in your Bird workspace.

Steps

  1. Sign in to Bird and connect your WhatsApp number.
  2. Create an API key with the whatsapp and whatsapp_management scopes. The second lets the app check the key against your template list.
  3. In Ultra WhatsApp open Numbers, click Connect a number, and choose I already have my details. Pick Bird from the list and paste the key and the sender. Click Test connection, then save.
  4. Add approved templates with Templates, Add manually, using the template slug as the name.
  5. Send a test template to your own number with Tools, Quick single send.

Good to know

  • Templates with a media header are refused here, because Bird's docs do not show the exact media parameter.
  • Ultra WhatsApp does not read delivery webhooks from Bird, so its report stops at Sent. See delivery and read results in Bird's dashboard.
  • Customer replies stay in Bird's dashboard. The Ultra WhatsApp inbox receives replies from the Meta Cloud API, 360dialog, Gupshup and Twilio.
  • Bird adds its own platform or per-message fees to Meta's charges; check its current plans.

When Bird makes sense

A provider can make onboarding easier and may be the account you already have, but it adds its own platform or per-message fees on top of Meta's charges. The rules stay the same either way: approved templates, opted-in contacts and Meta's messaging limits. Where the steps above set up a webhook, delivery statuses need that address saved in the provider's dashboard.

Dashboards change their menus from time to time; if a label differs, look for the API keys or developer section. Stuck? See the Ultra WhatsApp troubleshooting table, the Ultra WhatsApp user guide, or contact us.

Related guides and pages

WhatsApp is a trademark of Meta Platforms, Inc. Ultra WhatsApp is an independent product by Code Craft and is not affiliated with or endorsed by Meta.