API Reference

Através dos Webhooks você pode receber notificações em seu sistema para eventos previamente configurados.

O sistema tentará reenviar a mensagem caso não receba uma resposta de sucesso pelo seu sistema. Será considerado sucesso quando obtivermos o HTTP status entre 200 e 399 ou igual a 410. Caso o HTTP status seja diferente, a mensagem será reenviada por até 3 dias ou quando tiver sucesso.

A resposta para a requisição do webhook deve ser dada num intervalo de 10 segundos. Caso não seja respondido dentro de 10 segundos, ocorrerá um timeout na requisição.

Os webhooks podem ser configurados no painel da Meetime em: https://meetime.com.br/dashboard/integrations/webhooks ou configurados pelos endpoints de webhooks da API (https://meetime.readme.io/reference/criarwebhook)

Identificador da mensagem

Todas as mensagens são envidas com um identificador único em UUID para auditoria. O identificador é enviado no header X-Meetime-Delivery.

Segurança

Os webhooks possuem um secret associado que é utilizado para assinar o payload e assim garantir que foi enviado pela Meetime. O algoritmo utilizado é HmacSha256 e os bytes são convertidos para Base64 url safe. A assinatura é enviada no header X-Meetime-Signature.

IP de origem

Os webhooks são enviados a partir do IP 34.74.246.245.

Eventos

EventoDescrição
CALL.STARTEDLigação iniciada
CALL.PHONE_EVENTEventos de telefonia
CALL.FINISHEDLigação finalizada
CALL.UPDATEDLigação atualizada
LEAD.WONLead ganho no Flow
LEAD.LOSTLead perdido no Flow
LEAD_ACTIVITY.FINISHEDAtividade do Flow realizada
LEAD_ACTIVITY.IGNOREDAtividade do Flow ignorada