Skip to content
LanguageEN
Start free

WaliChat API + webhooks

Your system sends.Your team keeps the chat.

Send messages, receive events and assign conversations with the WaliChat API. The result appears where your team already works.

Start freeSee it in action

API access in WaliChat. Follow the messaging rules and the limits of your plan.

REST API
POST /v1/messages
  1. Your systemPrepare the message
  2. REST APIPOST /v1/messages
  3. WaliChatVisible in the chat

Your order is ready for pickup.

Request accepted · delivery is tracked separately

An independent developer reviews an integration from a café patio.

Your team sees the outgoing message.

Send an order update

Receive an incoming event

Assign the chat to Sara

From a request to the team inbox.

Three connected jobs: send, receive and assign.

Swipe to explore the examples

Send an order update

POST /v1/messages

Provide the connected device, recipient and message. Use an approved template when the official API requires one.

REST API
POST /v1/messages
  1. Your systemPrepare the message

    device + phone + message

  2. REST APIPOST /v1/messages

    Authenticate with your API key.

  3. WaliChatVisible in the chat

    Your team sees the outgoing message.

Your order is ready for pickup.

Request accepted · delivery is tracked separately

An accepted request does not guarantee delivery. Check status events and handle errors in your system.

Receive an incoming event

Can I pick up my order tomorrow?

Configure an HTTPS webhook and subscribe to the incoming-message event.

Webhook

Can I pick up my order tomorrow?

  1. WhatsAppMessage received

    The customer writes to the connected number.

  2. Webhookmessage:in:new

    The event reaches your HTTPS endpoint.

  3. Your handlerChoose the next action

    Read, process and decide what to do.

message:in:new

Webhook delivered to your configured endpoint

Your handler chooses the next action. Receiving an event does not automatically send a reply.

Assign the chat to Sara

PATCH /v1/chat/{device}/chats/{chat}/owner

Provide an authorized agent or department. Departments depend on your plan.

REST API
PATCH /v1/chat/{device}/chats/{chat}/owner
  1. Your systemChoose the owner

    agent / email / department

  2. REST APIPATCH …/owner

    Update the conversation owner.

  3. WaliChatGive the chat to Sara

    Sara continues with the existing context.

Assigned conversation

Sara is responsible for the chat

Assignment and notes organize the team; they do not send a message to the customer.

Choose the interface for the job.

Use your backend, a flow or a compatible AI client.

REST API

Read and update through documented JSON endpoints.

Webhooks

Receive the events you subscribe to in your own HTTPS handler.

MCP

Your AI, connected to the business.

API actions use the authority of your key and the limits of your plan. Meta messaging rules and charges still apply.

Read the API reference

Start with the real documentation.

A key. A test. Your first event.

Start in the documentation with a connected test number and review every response.

  1. Create an API key

    Use an account authorized for the number and keep the key in your backend.

  2. Test the request

    Use the documentation and API tester with your own test data.

  3. Handle events and errors

    Configure your webhooks and check response codes, limits and delivery states.

Before you start

  • A WaliChat account with a connected number and API access.
  • An HTTPS endpoint for the webhooks you subscribe to.
Start freeSee plans and terms
Two developers work on a laptop in a neighborhood coworking space.
Sara · WaliChat

I have the chat and the note. I can take it from here.

When a person is needed, your team has the chat.

Prepare the handoff for exceptions. Your team sees what happened and continues with the customer.

See how your team works

One conversationWith the sent messages

One ownerAssigned to the right person

Your access rulesRoles and access to the number

Before your first API request.

Does an accepted request mean delivery?

No. Check message status events and the documented response. Your system should handle failures and retries.

What happens outside the WhatsApp service window?

The official WhatsApp API keeps its rules. Outside the service window, use an approved template and follow the applicable messaging rules and charges.

Prepare the flow. Get on with your business.

Start free

Start with WaliChat and choose a plan with Flows.