MCP: Webhooks
Cadastrar, editar e acompanhar os webhooks do workspace pelo MCP. 6 ferramentas.
Ferramentas desta área, geradas do código do servidor. As descrições vêm desse código, em português. Para conectar, veja o MCP da XBASE.
create-webhook
Cadastra um webhook: a URL (https, pública) passa a receber em tempo real os eventos escolhidos dos números escolhidos. Devolve o segredo de assinatura UMA vez (guarde). Até 10 webhooks por workspace.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional: só é aceito se for o workspace do token (o workspace vem sempre da credencial) |
name | sim | — |
url | sim | — |
events | sim | Eventos: whatsapp.message.received (mensagem recebida), whatsapp.message.sent/delivered/read/failed (status das enviadas), instagram.comment e instagram.message |
format | sim | Formato do corpo: XBASE (padrão), com o número e o evento, assinado no cabeçalho x-xbase-signature |
connectionIds | não | Números de WhatsApp cobertos (veja list-webhook-numbers); vazio = todos |
delete-webhook
Exclui um webhook do workspace e o log de entregas dele. Não tem volta (para pausar, use update-webhook com enabled=false).
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional: só é aceito se for o workspace do token (o workspace vem sempre da credencial) |
webhookId | sim | ID do webhook (veja list-webhooks) |
list-webhook-deliveries
Últimas 20 entregas de um webhook: evento, status (PENDING/DELIVERED/FAILED), tentativas, status HTTP e erro.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional: só é aceito se for o workspace do token (o workspace vem sempre da credencial) |
webhookId | sim | ID do webhook (veja list-webhooks) |
list-webhook-numbers
Lista os números de WhatsApp do workspace que um webhook pode cobrir, com o connectionId a usar em create-webhook.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional: só é aceito se for o workspace do token (o workspace vem sempre da credencial) |
list-webhooks
Lista os webhooks do workspace (Integrações → Webhooks): URL, eventos, formato, números, ligado/desligado e a última entrega.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional: só é aceito se for o workspace do token (o workspace vem sempre da credencial) |
update-webhook
Altera um webhook do workspace (só os campos enviados): nome, URL, eventos, formato, números ou ligado/desligado (enabled).
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional: só é aceito se for o workspace do token (o workspace vem sempre da credencial) |
webhookId | sim | ID do webhook (veja list-webhooks) |
name | não | — |
url | não | — |
events | não | Eventos: whatsapp.message.received (mensagem recebida), whatsapp.message.sent/delivered/read/failed (status das enviadas), instagram.comment e instagram.message |
format | não | Formato do corpo: XBASE (padrão), com o número e o evento, assinado no cabeçalho x-xbase-signature |
connectionIds | não | Números de WhatsApp cobertos (veja list-webhook-numbers); vazio = todos |
enabled | não | false desliga o webhook sem apagar |