# WATI API Reference Documentation

## Guides
- [Documentation](https://docs.wati.io/docs.md): WATI API Reference documentation

## API Reference
- [Create Custom Segment](https://docs.wati.io/reference/post_api-v1-createcustomsegment.md)
- [Rotate Token](https://docs.wati.io/reference/post_api-v1-rotatetoken-1.md)
- [Assign User](https://docs.wati.io/reference/post_api-v1-assignoperator-1.md)
- [Update Chat Status](https://docs.wati.io/reference/post_api-v1-updatechatstatus-1.md)
- [Get existing chatbots](https://docs.wati.io/reference/get_api-v1-chatbots-1.md)
- [Start chatbot](https://docs.wati.io/reference/post_api-v1-chatbots-start-1.md)
- [Get Contacts List](https://docs.wati.io/reference/get_api-v1-getcontacts-1.md)
- [Add Contact](https://docs.wati.io/reference/post_api-v1-addcontact-whatsappnumber-1.md)
- [Update Contact Attributes](https://docs.wati.io/reference/post_api-v1-updatecontactattributes-whatsappnumber-1.md)
- [Update Contact Attributes](https://docs.wati.io/reference/post_api-v1-updatecontactattributesformulticontacts-1.md)
- [Get media by file name](https://docs.wati.io/reference/get_api-v1-getmedia-1.md)
- [Get Messages by whatsapp number](https://docs.wati.io/reference/get_api-v1-getmessages-whatsappnumber-1.md)
- [Get message by phoneNumber and localMessageId](https://docs.wati.io/reference/get_api-v1-whatsapp-messages-phonenumber-localmessageid-1.md)
- [Send Interactive Buttons Message](https://docs.wati.io/reference/post_api-v1-sendinteractivebuttonsmessage-1.md)
- [Send Interactive List Message](https://docs.wati.io/reference/post_api-v1-sendinteractivelistmessage-1.md)
- [Send File to opened session](https://docs.wati.io/reference/post_api-v1-sendsessionfile-whatsappnumber-1.md)
- [Send File to opened session via a url](https://docs.wati.io/reference/post_api-v1-sendsessionfileviaurl-whatsappnumber-1.md)
- [Send Message to opened session](https://docs.wati.io/reference/post_api-v1-sendsessionmessage-whatsappnumber-1.md)
- [Send a WhatsApp template message](https://docs.wati.io/reference/post_api-v1-sendtemplatemessage-1.md): Send a pre-approved WhatsApp template message to a contact. Use this endpoint to initiate a conversation outside the 24-hour customer service window — for example, notifications, marketing campaigns, or re-engagement messages. To reply within an active 24-hour session, use **sendSessionMessage** instead.              Behavior: - The `template_name` must reference a template that has been approved by WhatsApp.   Requests referencing pending or rejected templates return 400. - `parameters` are positional: the order in the array must match the placeholder   order in the approved template body (e.g., {{1}}, {{2}}, …). - `broadcast_name` is used for grouping and analytics in WATI dashboards; it does   not affect message delivery. - `channel_number` routes the message through a specific WhatsApp Business Account   when the tenant has multiple WABAs connected. - A 200 response means the message was accepted by WATI, not delivered yet. - To detect delivery failures, listen to the **Template Message Failed** webhook. - To detect successful delivery, listen to the **Delivered**, **Read**, or **Reply**   webhooks. - Marketing-category templates are subject to per-tenant daily limits; once the   limit is reached, subsequent calls return 400 until the next window. - The endpoint returns 400 when the tenant is in offline mode or when the   trial-plan broadcast quota is exhausted.
- [Send template messages(CSV)](https://docs.wati.io/reference/post_api-v1-sendtemplatemessagecsv-1.md)
- [Send template messages](https://docs.wati.io/reference/post_api-v1-sendtemplatemessages-1.md)
- [Send template message (Beta)](https://docs.wati.io/reference/post_api-v2-sendtemplatemessage-1.md)
- [Send template messages (Beta)](https://docs.wati.io/reference/post_api-v2-sendtemplatemessages-1.md)
- [Delete templates by name](https://docs.wati.io/reference/delete_api-v1-whatsapp-templates-wabaid-name-1.md)
- [Delete a template](https://docs.wati.io/reference/delete_api-v1-whatsapp-templates-wabaid-name-language-1.md)
- [Get Message Templates](https://docs.wati.io/reference/get_api-v1-getmessagetemplates-1.md)
- [Get templates](https://docs.wati.io/reference/get_api-v2-getmessagetemplates-1.md)
- [Create a template](https://docs.wati.io/reference/post_api-v1-whatsapp-templates-1.md)
- [Create webhooks](https://docs.wati.io/reference/post_api-v2-webhookendpoints-1.md)
- [BusinessAccounts](https://docs.wati.io/reference/get_api-v1-whatsapp-businessaccounts-1.md)
- [GetPhoneNumberList](https://docs.wati.io/reference/get_api-v1-whatsapp-phonenumbers-1.md)
- [List multi whatsapp phone number](https://docs.wati.io/reference/get_api-v2-whatsapp-phonenumbers-1.md)
- [Get phone number detail](https://docs.wati.io/reference/get_api-v2-whatsapp-wabaid-phonenumber-profile-1.md)
- [Get WhatsApp Pay order details of particular order (Private Beta)](https://docs.wati.io/reference/get_api-v1-order-details-referenceid-1.md)
- [Get payment status information of particular order (Private Beta)](https://docs.wati.io/reference/get_api-v1-payment-status-referenceid-1.md)
- [Send WhatsApp Pay order detail message to customer (Private Beta)](https://docs.wati.io/reference/post_api-v1-order-details-1.md)
- [Update WhatsApp Pay order status of an order (Private Beta)](https://docs.wati.io/reference/post_api-v1-order-status-1.md)
- [Get the campaign recipients by ID](https://docs.wati.io/reference/get_api-ext-v3-broadcasts-broadcast-id-recipients.md)
- [Get the campaign details by ID](https://docs.wati.io/reference/get_api-ext-v3-broadcasts-broadcast-id.md)
- [Get the campagin overview](https://docs.wati.io/reference/get_api-ext-v3-broadcasts-overview.md)
- [Get campaigns](https://docs.wati.io/reference/get_api-ext-v3-broadcasts.md)
- [Get channels](https://docs.wati.io/reference/get_api-ext-v3-channels.md)
- [Get chatbots (Available in Pro plan)](https://docs.wati.io/reference/get_api-ext-v3-chatbots.md)
- [Start chatbot (Available in Pro plan)](https://docs.wati.io/reference/post_api-ext-v3-chatbots-start.md)
- [Get contact count](https://docs.wati.io/reference/get_api-ext-v3-contacts-count.md)
- [Get contact details](https://docs.wati.io/reference/get_api-ext-v3-contacts-target.md)
- [Get contacts](https://docs.wati.io/reference/get_api-ext-v3-contacts.md)
- [Add a new contact](https://docs.wati.io/reference/post_api-ext-v3-contacts.md)
- [Assigns a contact to teams](https://docs.wati.io/reference/put_api-ext-v3-contacts-teams.md)
- [Update contacts](https://docs.wati.io/reference/put_api-ext-v3-contacts.md)
- [Get a media file by message ID](https://docs.wati.io/reference/get_api-ext-v3-conversations-messages-file-message-id.md)
- [Get messages](https://docs.wati.io/reference/get_api-ext-v3-conversations-target-messages.md)
- [Send a file message to an active conversation](https://docs.wati.io/reference/post_api-ext-v3-conversations-messages-file.md)
- [Send a file message to an active conversation via a url](https://docs.wati.io/reference/post_api-ext-v3-conversations-messages-fileviaurl.md)
- [Send an interactive message to an active conversation](https://docs.wati.io/reference/post_api-ext-v3-conversations-messages-interactive.md)
- [Send a text message to an active conversation](https://docs.wati.io/reference/post_api-ext-v3-conversations-messages-text.md)
- [Assign an operator to a conversation](https://docs.wati.io/reference/put_api-ext-v3-conversations-target-operator.md)
- [Update conversation status](https://docs.wati.io/reference/put_api-ext-v3-conversations-target-status.md)
- [Get message template by ID](https://docs.wati.io/reference/get_api-ext-v3-messagetemplates-template-id.md)
- [Get message templates](https://docs.wati.io/reference/get_api-ext-v3-messagetemplates.md)
- [Schedule template messages](https://docs.wati.io/reference/post_api-ext-v3-messagetemplates-schedule.md)
- [Send template messages](https://docs.wati.io/reference/post_api-ext-v3-messagetemplates-send.md)
- [Get lead stages](https://docs.wati.io/reference/get_api-ext-v3-salesanalytics-leadstages.md): Returns the list of lead stages.
- [Get sales pipeline](https://docs.wati.io/reference/post_api-ext-v3-salesanalytics-pipeline.md): Note: - From date and to date are in ISO 8601 format of UTC timezone. - Set agentIds to null or exclude it to include all agents in the results. - Set stageIds to null or exclude it to include all stages in the results.
- [Authentication](https://docs.wati.io/reference/authentication.md)
- [Endpoint availability by plan](https://docs.wati.io/reference/endpoint-availability-by-plan.md)
- [Errors & Rate Limits](https://docs.wati.io/reference/errors.md)
- [Introduction](https://docs.wati.io/reference/introduction.md)
- [Public Roadmap](https://docs.wati.io/reference/public-roadmap.md): See what features are planned for future and request more features
- [Introduction](https://docs.wati.io/reference/introduction-1.md)
- [Message Received](https://docs.wati.io/reference/message-received.md)
- [New Contact Message](https://docs.wati.io/reference/new-contact-message.md)
- [Phone Number Deleted ](https://docs.wati.io/reference/phone-number-deleted.md)
- [Phone Number Quality Update Event](https://docs.wati.io/reference/phone-number-quality-update.md)
- [Send Message is Read](https://docs.wati.io/reference/send-message-is-read.md)
- [Sent Message is DELIVERED](https://docs.wati.io/reference/sent-message-is-delivered.md)
- [Sent Message is REPLIED](https://docs.wati.io/reference/sent-message-is-replied.md)
- [Session Message Sent](https://docs.wati.io/reference/session-message-sent.md)
- [Template category update](https://docs.wati.io/reference/template-category-update.md)
- [Template Message FAILED](https://docs.wati.io/reference/template-message-failed.md): Webhook event structure and field descriptions for template message failed events in WATI platform
- [Template Message Sent](https://docs.wati.io/reference/template-message-sent.md)
- [Template quality update](https://docs.wati.io/reference/template-quality-update.md)
- [Template Status Update](https://docs.wati.io/reference/template-status-update.md)
- [WABA Account Content Updated](https://docs.wati.io/reference/waba-account-content-updated.md)
- [WABA Account Deleted](https://docs.wati.io/reference/waba-account-deleted.md)
- [WABA Status Review Update](https://docs.wati.io/reference/waba-status-review-update.md)

## Recipes
- [Get Media](https://docs.wati.io/recipes/get-media.md)
- [Send Session File](https://docs.wati.io/recipes/send-session-file.md)
- [Send Session Message](https://docs.wati.io/recipes/send-session-message.md)
- [Send Template Message](https://docs.wati.io/recipes/send-template-message.md)
- [Send Template Messages - V3](https://docs.wati.io/recipes/send-template-messages-v3.md)
- [Send Template Messages](https://docs.wati.io/recipes/send-template-messages.md)
- [Sending Session Messages - V3](https://docs.wati.io/recipes/sending-session-messages.md)

## Pages
- [Public Roadmap](https://docs.wati.io/public-roadmap.md)