Contato criado

Webhook

POST

contact.created

Disparado quando um contato novo é criado — inbound de qualquer canal (WhatsApp
Cloud API, QR, Gupshup, widget web), pela API, pelo painel ou por envio de template
para um número ainda desconhecido.

Não dispara na importação de planilha. Um arquivo de milhares de linhas geraria
uma entrega por contato, o suficiente para derrubar o endpoint assinante.
Contatos sintéticos do Playground do assistente também são ignorados.

Requisição

Parâmetros Bodyapplication/jsonNecessário

Exemplo

{
    "event": "contact.created",
    "organization_id": 1,
    "contact": {
        "uuid": "7a2b3c4d-5e6f-4a8b-9c0d-1e2f3a4b5c6d",
        "name": "Maria Souza",
        "phone": "+5511888880000",
        "email": "maria@exemplo.com",
        "channel": "whatsapp",
        "created_at": "2026-01-01T10:00:00Z"
    }
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event": "contact.created",
    "organization_id": 1,
    "contact": {
        "uuid": "7a2b3c4d-5e6f-4a8b-9c0d-1e2f3a4b5c6d",
        "name": "Maria Souza",
        "phone": "+5511888880000",
        "email": "maria@exemplo.com",
        "channel": "whatsapp",
        "created_at": "2026-01-01T10:00:00Z"
    }
}'

Respostas

🟢200OK

Recebido.

Esta resposta não possui corpo.

Modificado em 2026-07-17 16:50:55

Página anterior

Ticket de atendimento fechado

Próxima página

IA pediu atendimento humano