Enviar uma mensagem

Envia uma mensagem do WhatsApp de um dos seus números conectados. Suporta texto, templates, imagens, documentos, áudio, vídeo, localização e mensagens interativas. Adicione o header Idempotency-Key para evitar envios duplicados.

Authentication

AuthorizationBearer

API Key in the format mk_live_<43-chars>. Obtain from the Dashboard or POST /auth/api-keys.

Request

This endpoint expects an object.
number_idstringRequired
ID of the WhatsApp number to send from
typeenumRequired
Type of WhatsApp message to send
tostringOptional

Recipient phone number in E.164 format (e.g., 5511999998888)

recipientstringOptional

Recipient BSUID (e.g., US.13491208655302741918)

textobjectOptional

Text message payload — required when type is ‘text’

templateobjectOptional

Template message payload — required when type is ‘template’

imageobjectOptional

Image message payload — required when type is ‘image’. Provide either id or link

documentobjectOptional

Document message payload — required when type is ‘document’. Provide either id or link

audioobjectOptional

Audio message payload — required when type is ‘audio’. Provide either id or link

videoobjectOptional

Video message payload — required when type is ‘video’. Provide either id or link

locationobjectOptional

Location message payload — required when type is ‘location’

interactivemap from strings to anyOptional

Interactive message payload (list, button, product, etc.) — required when type is ‘interactive’

Response

Default Response
idstring
Muchaw DEV internal message ID
wa_message_idstring
WhatsApp message ID returned by Meta Cloud API
statusstring
Current delivery status of the message

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error