WhatsApp coexistence

Coexistence connects your WhatsApp Business app number to Bird. You keep using the app to message customers and use the same number for API sends, automations, and your team's Conversations inbox.

When to use coexistence

Use coexistence if your team already works in the WhatsApp Business app and needs to keep replying from it after connecting to Bird. For example, staff can answer customers from the app as you add automated order updates through the API.

If you do not need the Business app, use standard number setup. Coexistence requires an existing Business app account and limits API throughput.

Limits and app changes

Coexistence numbers have a fixed API throughput of 20 messages per second, as specified in Meta's coexistence limitations. If you need higher throughput, use a number connected without coexistence.

One-to-one messages sync between the app and Bird. During connection, you can also choose to share existing chat history. Some app features change:

• Group chats stay in the app and do not sync to Bird.
• Broadcast lists become read-only, and you cannot create new ones in the app.
• Disappearing messages and view-once messages are disabled for one-to-one chats.
• Linked devices disconnect during setup. You can reconnect supported devices afterwards.

See Meta's feature comparison and linked-device support before connecting.

Cost

Connecting a coexistence number has no additional charge.

Messages you send from the WhatsApp Business app remain free under Meta's coexistence pricing. Bird does not charge for recording those messages.

Messages you send through Bird follow the WhatsApp messaging rates. See Cost and billing for how charges apply.

Messages sent from the app

{
  "direction": "outbound",
  "from": {
    "phone_number": "+14155550100"
  },
  "to": {
    "phone_number": "+14155550101"
  },
  ...
  "origin": "business_app_echo"
}

Next steps

• Connect your WhatsApp Business app number.
• Manage WhatsApp conversations.