Eventos disponíveis para este serviço.
| Método | Evento | Identificador | Descrição |
|---|---|---|---|
| POST | Mensagem - Criação | messenger/chat/message/create | Configure um webhook de saída em /integration, ative-o e selecione MESSENGER / Mensagem: Criação e/ou Atualização. Recebe uma mensagem persistida por POST, com room, project, eventName, eventType, eventDt e verifyKey. Inclui mensagens recebidas e enviadas, de agentes, bots e disparos; Atualização inclui edições e mudanças de status realizadas pelo serviço. Só integrações ativas do mesmo projeto e inscritas neste evento recebem a entrega. Em atualização em lote, cada mensagem gera uma entrega. Não há filtro de room no cadastro; o consumidor pode filtrar pelo room recebido. O limite de 500 e as 300 consultas/minuto são exclusivos da listagem REST e não limitam estes eventos. files inclui downloadUrl, downloadUrlExpiresAt (null) e downloadRequiresAuth. Nenhum arquivo é baixado, consultado no storage ou assinado ao preparar o webhook. URLs temporárias já recebidas de Facebook/Instagram podem ser reutilizadas sem chamada adicional; demais anexos usam as mesmas rotas sob demanda da API. Quando downloadRequiresAuth=true, chame a URL relativa no host da API com X-API-Key de uma chave do mesmo projeto e siga redirecionamentos. Download revalida projeto e arquivo. Responda 200 rapidamente; o timeout é de 30 segundos. Falhas usam o registro e job de reenvio existentes, executado aproximadamente a cada 12 minutos. A entrega pode se repetir: deduplique por eventName, _id e updatedAt. A integração é desativada após 10 falhas consecutivas em até uma hora; sucesso limpa o contador. |
| POST | Mensagem - Atualização | messenger/chat/message/patch | Configure um webhook de saída em /integration, ative-o e selecione MESSENGER / Mensagem: Criação e/ou Atualização. Recebe uma mensagem persistida por POST, com room, project, eventName, eventType, eventDt e verifyKey. Inclui mensagens recebidas e enviadas, de agentes, bots e disparos; Atualização inclui edições e mudanças de status realizadas pelo serviço. Só integrações ativas do mesmo projeto e inscritas neste evento recebem a entrega. Em atualização em lote, cada mensagem gera uma entrega. Não há filtro de room no cadastro; o consumidor pode filtrar pelo room recebido. O limite de 500 e as 300 consultas/minuto são exclusivos da listagem REST e não limitam estes eventos. files inclui downloadUrl, downloadUrlExpiresAt (null) e downloadRequiresAuth. Nenhum arquivo é baixado, consultado no storage ou assinado ao preparar o webhook. URLs temporárias já recebidas de Facebook/Instagram podem ser reutilizadas sem chamada adicional; demais anexos usam as mesmas rotas sob demanda da API. Quando downloadRequiresAuth=true, chame a URL relativa no host da API com X-API-Key de uma chave do mesmo projeto e siga redirecionamentos. Download revalida projeto e arquivo. Responda 200 rapidamente; o timeout é de 30 segundos. Falhas usam o registro e job de reenvio existentes, executado aproximadamente a cada 12 minutos. A entrega pode se repetir: deduplique por eventName, _id e updatedAt. A integração é desativada após 10 falhas consecutivas em até uma hora; sucesso limpa o contador. |