curl -X POST "https://demo.api.vultlocal.com/api/v1/external/whatsapp" \
-H "Content-Type: application/json" \
-d '{
"event": "message",
"message": "What is my balance?",
"from": "23279648205@c.us",
"phoneE164": "+23279648205"
}'
{
"answer": "Your balance is 5,000 SLE",
"status": "success"
}
{
"answer": "You are not registered. Reply with your full name to register.",
"status": "success"
}
{
"error": "Missing required field: message",
"status": "error"
}
Webhooks
WhatsApp Webhook
Kapso-first WhatsApp message webhooks
POST
/
external
/
whatsapp
curl -X POST "https://demo.api.vultlocal.com/api/v1/external/whatsapp" \
-H "Content-Type: application/json" \
-d '{
"event": "message",
"message": "What is my balance?",
"from": "23279648205@c.us",
"phoneE164": "+23279648205"
}'
{
"answer": "Your balance is 5,000 SLE",
"status": "success"
}
{
"answer": "You are not registered. Reply with your full name to register.",
"status": "success"
}
{
"error": "Missing required field: message",
"status": "error"
}
Receive and process WhatsApp messages via Agent-TS. Kapso is the supported transport;
/api/v1/external/whatsapp remains only as a compatibility test bridge.Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /api/v1/external/whatsapp | Compatibility test bridge |
GET | /api/v1/webhooks/whatsapp | Meta webhook verification |
POST | /api/v1/webhooks/whatsapp | Meta webhook messages |
External Client Request
string
required
Event type (e.g.,
message)string
required
Message content from user
string
required
WhatsApp ID (e.g.,
23279648205@c.us)string
required
Phone number in E.164 format
Response
string
Agent response message
string
Processing status (
success, error)Examples
curl -X POST "https://demo.api.vultlocal.com/api/v1/external/whatsapp" \
-H "Content-Type: application/json" \
-d '{
"event": "message",
"message": "What is my balance?",
"from": "23279648205@c.us",
"phoneE164": "+23279648205"
}'
{
"answer": "Your balance is 5,000 SLE",
"status": "success"
}
{
"answer": "You are not registered. Reply with your full name to register.",
"status": "success"
}
{
"error": "Missing required field: message",
"status": "error"
}
Meta Business API
Verification (GET)
Meta sends a verification request when setting up the webhook:GET /api/v1/webhooks/whatsapp?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=CHALLENGE
hub.challenge if hub.verify_token matches.
Messages (POST)
Meta sends incoming messages as POST requests with the message payload.Related
Agent-TS Webhooks
Detailed webhook configuration and message handling
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Response
200 - application/json
Success
The response is of type object.
⌘I