Start conversation

Requires conversations:start. WhatsApp only. Requires approved prepared template and recipient consent; respects opt-outs. Reuse Idempotency-Key with identical input only. Keys are scoped to the tenant and target conversation. Use requestEventId with message-request status to reconcile.

post/conversations/start

Request

  • Base URL
    https://platform-api.visitoai.com/m2m/v1
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring required

Request body

channel'whatsapp' required
targetChannelIdstring required
phoneNumberstring required
contactNamestring
locale'en_US' | 'es_MX' required
messageTextstring required
consentConfirmedtrue required

Response

Accepted and queued, not delivered

replyIdstring
requestEventIdstring
conversationIdstring required
status'queued' required

Changes

No recorded changes to this operation across all 1 revision of this API.