# WhatsApp API

Connect WhatsApp numbers, work their conversations and put an agent on each number.

- [Connect a WhatsApp number](https://www.nabrah.ai/en/docs/api-reference/whatsapp/connect-a-whatsapp-number.md) `POST /api/ext/omni_v2/whatsapp/inboxes`: Connect a new WhatsApp number to the project by creating a WhatsApp inbox.
- [List WhatsApp inboxes](https://www.nabrah.ai/en/docs/api-reference/whatsapp/list-whatsapp-inboxes.md) `GET /api/ext/omni_v2/whatsapp/inboxes`: List the WhatsApp inboxes connected to the project, oldest first.
- [Get WhatsApp inbox](https://www.nabrah.ai/en/docs/api-reference/whatsapp/get-whatsapp-inbox.md) `GET /api/ext/omni_v2/whatsapp/inboxes/{inbox_id}`: Retrieve the full details of a single WhatsApp inbox by its id.
- [Update WhatsApp inbox](https://www.nabrah.ai/en/docs/api-reference/whatsapp/update-whatsapp-inbox.md) `PATCH /api/ext/omni_v2/whatsapp/inboxes`: Update the configuration of one of the project's WhatsApp inboxes, such as its WhatsApp Cloud API credentials, phone number details, webhook verify token, auto-assignment behavior, and display name.
- [Delete WhatsApp inbox](https://www.nabrah.ai/en/docs/api-reference/whatsapp/delete-whatsapp-inbox.md) `DELETE /api/ext/omni_v2/whatsapp/inboxes`: Delete one of the project's WhatsApp inboxes, disconnecting that WhatsApp number from the project.
- [Create WhatsApp conversation](https://www.nabrah.ai/en/docs/api-reference/whatsapp/create-whatsapp-conversation.md) `POST /api/ext/omni_v2/whatsapp`: Create a new WhatsApp conversation (ticket) for a contact and return the full conversation object.
- [List WhatsApp conversations](https://www.nabrah.ai/en/docs/api-reference/whatsapp/list-whatsapp-conversations.md) `GET /api/ext/omni_v2/whatsapp`: List WhatsApp conversations (tickets) on one of the project's WhatsApp numbers, with optional filtering by assignment and status, plus search by the customer's phone number or message text.
- [Filter WhatsApp conversations](https://www.nabrah.ai/en/docs/api-reference/whatsapp/filter-whatsapp-conversations.md) `POST /api/ext/omni_v2/whatsapp/filter`: List WhatsApp conversations on one of the project's WhatsApp numbers using a structured filter payload instead of simple query parameters.
- [List WhatsApp conversations by contact](https://www.nabrah.ai/en/docs/api-reference/whatsapp/list-whatsapp-conversations-by-contact.md) `POST /api/ext/omni_v2/whatsapp/contact/{contact_id}`: Lists the WhatsApp conversations of the contact identified by contact_id on one of the project's WhatsApp numbers, with optional server-side filtering in the request body and pagination via the page query parameter.
- [Assign an agent to a WhatsApp number](https://www.nabrah.ai/en/docs/api-reference/whatsapp/assign-an-agent-to-a-whatsapp-number.md) `POST /api/ext/omni_v2/whatsapp/assign_chatbot`: Attach an AI agent to one of the project's WhatsApp numbers so it automatically replies to incoming WhatsApp messages on that number.
- [Get the agent on a WhatsApp number](https://www.nabrah.ai/en/docs/api-reference/whatsapp/get-the-agent-on-a-whatsapp-number.md) `GET /api/ext/omni_v2/whatsapp/get_chatbot`: Retrieve the agent currently answering on one of the project's WhatsApp numbers.
- [Remove the agent from a WhatsApp number](https://www.nabrah.ai/en/docs/api-reference/whatsapp/remove-the-agent-from-a-whatsapp-number.md) `DELETE /api/ext/omni_v2/whatsapp/unassign_chatbot`: Remove the agent from one of the project's WhatsApp numbers, stopping automatic AI replies on that number.
- [Get WhatsApp analytics](https://www.nabrah.ai/en/docs/api-reference/whatsapp/get-whatsapp-analytics.md) `POST /api/ext/omni_v2/whatsapp/analytics`: Get aggregated WhatsApp conversation analytics for a date window.