Criar webhook

Cadastra um webhook para receber eventos de WhatsApp, e-mail e campanhas.

POSThttps://external-api.lip7.com.br/api/external/webhooks

Escopowebhooks:manageSíncrono — responde 200 com os dados

Registra uma URL que passa a receber os eventos assinados. Veja Eventos e payload para a lista completa e o formato das entregas.

Body

namestringobrigatório

Nome de identificação do webhook.

urlstringobrigatório

URL HTTPS que receberá as entregas.

eventsarrayobrigatório

Lista de eventos a assinar.

secretstringopcional

Segredo usado na assinatura HMAC. Se omitido, geramos um automaticamente.

headersobjectopcional

Headers adicionais enviados em cada entrega.

retryConfigobjectopcional

Aceita maxRetries (padrão 3) e backoffMs (padrão 1000).

Guarde o secret

O secret é o que permite validar a assinatura das entregas. Se ele for gerado automaticamente, copie-o da resposta — veja Assinatura HMAC.

Requisição

{
  "name": "Webhook CRM",
  "url": "https://seu-dominio.com/webhooks/lip",
  "events": ["WHATSAPP_RECEIVED", "WHATSAPP_SENT"],
  "secret": "minha_chave_secreta",
  "retryConfig": { "maxRetries": 3, "backoffMs": 1000 }
}

curl -X POST "https://external-api.lip7.com.br/api/external/webhooks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: lip_SUA_CHAVE" \
  -d '{
    "name": "Webhook CRM",
    "url": "https://seu-dominio.com/webhooks/lip",
    "events": ["WHATSAPP_RECEIVED", "WHATSAPP_SENT"]
  }'

Resposta

{
  "success": true,
  "data": {
    "id": "wh_...",
    "name": "Webhook CRM",
    "url": "https://seu-dominio.com/webhooks/lip",
    "events": ["WHATSAPP_RECEIVED", "WHATSAPP_SENT"],
    "isActive": true
  }
}