Os webhooks da Sayelo, agente de voz com IA, enviam cada chamada tratada para o seu CRM, a sua ferramenta de tickets ou o seu planeamento: resumo, análise e ficha de contacto, sem voltar a introduzir dados. Estão incluídos nos 4 planos, desde 39 €/mês + IVA, configuram-se em 2 minutos e cada envio é assinado em HMAC-SHA256.
POST https://votre-logiciel.fr/webhooks/sayelo
X-Sayelo-Event: call.completed
X-Sayelo-Delivery: dlv_9f2c47e1a8b3
X-Sayelo-Signature: sha256=1e0e6a…
{
"event": "call.completed",
"call": {
"duration_seconds": 154,
"from": "+33 6 12 34 56 78",
"outcome": "Rendez-vous pris",
"agent": "Accueil — Cabinet Vernet"
},
"contact": {
"first_name": "Marie",
"last_name": "Lefèvre",
"company": "Lefèvre Immobilier"
},
"summary": "Marie Lefèvre souhaitait déplacer son
rendez-vous de jeudi. Créneau de vendredi
10 h 30 proposé, confirmé et enregistré.",
"analysis": {
"key_points": ["Report de rendez-vous"],
"actions": ["Confirmer la salle 2 vendredi"],
"sentiment": "positif"
}
} Configuração
Na aplicação: «Conta» → «Webhooks», adicione um webhook. Cole o URL do seu software e escolha os eventos. O segredo de assinatura é gerado automaticamente.
O botão «Enviar um teste» verifica a ligação de imediato. Um registo mostra as 20 últimas entregas: estado, código HTTP, data.
Cada chamada tratada chega à sua ferramenta. Precisa de suspender um agente? Em «Conta» → «Webhooks», o interruptor desse agente corta a transmissão das chamadas dele sem afetar os outros.
Casos de utilização
Um cliente comunica um problema por telefone? O evento message.taken cria o ticket na sua ferramenta, com o resumo e os contactos.
Cada conversa junta-se à ficha do cliente: resumo, pontos-chave, ações a realizar. O histórico comercial constrói-se sozinho.
Os «ligue-me de volta» tornam-se tarefas na sua ferramenta de acompanhamento, em vez de ficarem numa caixa de correio.
Referência
Dois eventos cobrem o ciclo de vida de uma chamada. Escolhe quais quer receber, webhook a webhook.
| Evento | Emitido quando… |
|---|---|
call.completed | Uma chamada foi tratada pelo agente — com a duração, o resultado, o resumo e a análise. |
message.taken | O agente anotou uma mensagem ou um pedido de chamada de volta. Ideal para criar tickets. |
Cada entrega é um POST JSON com as informações da chamada (duração, número, resultado, agente), a ficha de contacto do diretório (apelido, nome, empresa), o resumo da conversa, a análise estruturada (pontos-chave, ações a realizar, sentimento) e uma ligação direta para a ficha da chamada na aplicação, onde se encontram a transcrição e a gravação.
O esquema acima é um exemplo ilustrativo — a forma mais simples de ver o formato exato enviado para o seu software é o botão «Enviar um teste».
| Cabeçalho | Função |
|---|---|
X-Sayelo-Event | O tipo de evento: call.completed ou message.taken. |
X-Sayelo-Delivery | O identificador único da entrega. Mantém-se igual num reenvio: ignore os identificadores já tratados para evitar duplicados. |
X-Sayelo-Signature | A assinatura HMAC-SHA256 do corpo do pedido, calculada com o seu segredo (sha256=…). |
Segurança
Cada pedido é assinado em HMAC-SHA256 com o segredo gerado na criação do webhook. Ao recalcular a assinatura do lado do recetor, tem a garantia de que o envio vem da Sayelo e de que o corpo não foi alterado.
O áudio e a transcrição nunca passam pelo webhook: o payload contém uma ligação para a ficha da chamada na aplicação, onde continuam disponíveis para consulta.
// Node.js — vérifier la signature
const crypto = require("crypto");
function vientDeSayelo(corpsBrut, signature, secret) {
const attendu = "sha256=" + crypto
.createHmac("sha256", secret)
.update(corpsBrut, "utf8")
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(attendu),
Buffer.from(signature)
);
} Fiabilidade
Em caso de falha de entrega, a Sayelo reenvia automaticamente o pedido ao fim de 2 minutos, 10 minutos, 30 minutos e depois 2 horas — cinco tentativas no total. O cabeçalho X-Sayelo-Delivery mantém-se igual de uma tentativa para a outra: o seu recetor pode ignorar uma entrega já tratada, sem duplicados possíveis. O registo das 20 últimas entregas, na aplicação, mostra o estado e o código HTTP de cada tentativa.
Os webhooks de saída estão incluídos em todos os planos pagos.
Dois minutos de configuração, um teste imediato, e cada chamada tratada chega ao seu software de gestão.
Experimentar grátis durante 14 dias →
Uma ajudinha para a Sayelo?
Com o seu consentimento, os cookies medem a audiência do site e a eficácia dos nossos anúncios (Google, Meta), para mostrar a Sayelo às empresas que ela pode ajudar. Pode alterar a qualquer momento.