> For the complete documentation index, see [llms.txt](https://docs.taqnyat.sa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taqnyat.sa/api-reference/send-conversation-messages.md).

# Send Conversation Messages

Send supported messages during an active WhatsApp conversation.

## Send Conversation Message

> Send a supported WhatsApp message during an active customer conversation.\
> The request body changes according to the message type.<br>

```json
{"openapi":"3.0.3","info":{"title":"Taqnyat WhatsApp API - Send Conversation Messages","version":"2.0"},"tags":[{"name":"Send Conversation Messages","description":"Send supported messages during an active WhatsApp conversation."}],"servers":[{"url":"https://api.taqnyat.sa/wa/v2","description":"Taqnyat WhatsApp API"}],"security":[{"ApiToken":[]}],"components":{"securitySchemes":{"ApiToken":{"type":"apiKey","in":"header","name":"Authorization","description":"Taqnyat API token."}},"schemas":{"ConversationMessageRequest":{"type":"object","required":["to","type"],"properties":{"to":{"type":"string","description":"Recipient phone number."},"type":{"type":"string","description":"Message type.","enum":["interactive","text","reaction","image","audio","video","document","contacts","location"]},"text":{"type":"object","additionalProperties":true},"interactive":{"type":"object","additionalProperties":true},"image":{"type":"object","additionalProperties":true},"audio":{"type":"object","additionalProperties":true},"video":{"type":"object","additionalProperties":true},"document":{"type":"object","additionalProperties":true},"contacts":{"type":"array","items":{"type":"object","additionalProperties":true}},"location":{"type":"object","additionalProperties":true}}},"ConversationMessageResponse":{"type":"object","properties":{"type":{"type":"string"},"statuses":{"type":"object","properties":{"message_id":{"type":"string"},"recipient":{"type":"string"}}}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"reason":{"type":"string"}}}}},"paths":{"/messages/":{"post":{"tags":["Send Conversation Messages"],"summary":"Send Conversation Message","description":"Send a supported WhatsApp message during an active customer conversation.\nThe request body changes according to the message type.\n","operationId":"sendConversationMessage","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationMessageRequest"}}}},"responses":{"200":{"description":"Message accepted successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationMessageResponse"}}}},"400":{"description":"Invalid request parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Invalid or missing API token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Invalid or disallowed recipient.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}}}
```