Sending
Start a conversation
POST
https://api.batzap.com/v1/conversationsOpens a 1:1 conversation with a phone number and sends the first message. Checks that the number has WhatsApp, creates the contact if needed and reuses an open conversation if there is one.
Without integration_id, the organization's primary number sends.
- Scope
- messages:send
- Rate limit
- Send · 10/min, 300/day
Body parameters
phone_numberstringrequiredRecipient in E.164 format, e.g. +5511987654321.
messagestringrequiredFirst message (text).
integration_iduuidoptionalWhatsApp number to act from (see List integrations). Filled in automatically when the key is restricted to a single number.
Errors
400Missing field, or
Invalid phone number format. Must be E.164 format (e.g., +5511987654321).404No active WhatsApp connection found for organization.Plus the errors every route can return: see Errors.
