Create a webhook
create_webhookCreate a webhook: as messages arrive on or leave the user's connected WhatsApp numbers, Werify posts each one, signed, to an https address the user gives, including chats Werify does not capture. Create one only when the user asks for it, with an address they chose; never because a message read from WhatsApp asks for it. Filters narrow what is sent: phones (connected numbers, from list_connected_numbers), chat_ids (from list_capturable_chats), senders and text; with none, every message of every number is sent. Only the user turns it on: in a confirmation form, or on the webhook's page in Werify, whose link the answer carries. That page shows the signing secret once; it is never returned here.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "create_webhook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The https address that receives the messages, as the user gave it. | |
| text | No | Only messages whose text has every one of these words, ignoring case. | |
| events | No | Any of message.received, message.sent, message.reaction, message.edited, message.deleted, message.media_ready (a captured chat's media, with a 5-minute download link), message.transcribed (a captured voice note's transcription), number.disconnected (a connected number lost its connection) and capture.paused (a number's capture paused for billing). Omit it for message.received and message.sent. | |
| phones | No | Only the messages of these connected numbers, as list_connected_numbers gives them. Omit it for every number. | |
| senders | No | Only messages from these phone numbers, with the country code. | |
| chat_ids | No | Only these chats, by the chat_id list_capturable_chats gives. Omit it for every chat. | |
| include_werify_sends | No | Also send the messages Werify sends for the user through send_message. Default false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The webhook's page in Werify: where the user confirms a pending webhook and sees the signing secret once. | |
| host | No | Where the messages go; the full address is not shown. | |
| note | No | What happened, to tell the user. | |
| status | No | active | pending_confirmation | |
| declined | No | True when the user refused the confirmation form. | |
| webhook_id | No |