Integração
Ligue o LinkZap ao resto do seu sistema
Uma API REST para criar contato, enviar mensagem e começar um fluxo, e webhooks que avisam o seu servidor quando algo acontece aqui — assinados, para você conferir que vieram de nós.
- Token por organizaçãoCriado em Configurações → Integrações. Só o hash fica no nosso banco: se você perder o token, cria outro — nós não temos como mostrá-lo de volta.
- Nove eventosMensagem recebida e enviada, conversa aberta, resolvida, atribuída e com setor trocado, contato criado, opt-in e opt-out.
- Assinatura HMACCada entrega leva o corpo assinado com o seu segredo, em SHA-256. Confira antes de confiar — e a URL de destino não pode apontar para rede interna.
- Reenvio com recuoSe o seu servidor não responder, tentamos de novo em 1 minuto, 5, 30, 2 horas e 12 horas, e desistimos na sexta. O botão de ping entrega na hora e mostra o status real.
Enviar uma mensagem
Cria o contato e a conversa se ainda não existirem. Responde 409, com o motivo real, quando o canal não está pronto para enviar.
curl
curl -X POST https://linkzap.orion.moe/api/v1/messages \
-H "Authorization: Bearer lz_..." \
-H "Content-Type: application/json" \
-d '{
"channelId": "...",
"phone": "5511999999999",
"text": "Seu pedido saiu para entrega."
}'Receber um webhook
Os três cabeçalhos que acompanham toda entrega. Recalcule o HMAC do corpo com o seu segredo e compare com a assinatura antes de processar.
HTTP
X-LinkZap-Event: conversation.resolved
X-LinkZap-Delivery: 3f9c1e...
X-LinkZap-Signature: sha256=<HMAC-SHA256 do corpo>Dúvidas
Perguntas sobre integração
Veja também