Configuração

Webhooks enviam notificações HTTP POST em tempo real quando eventos ocorrem no MeChat.

Criando um Webhook

1. Acesse o módulo de Webhooks

Dentro do sistema, vá em Configurações → Webhooks.

2. Crie um novo Webhook

Clique em Novo Webhook e preencha os campos:

Campo	Obrigatório	Descrição
Nome	Sim	Nome identificável
URL	Sim	Endpoint HTTPS que receberá os webhooks
Canais	Não	Filtrar por canais específicos
Secret Key	Não	Chave para validar origem

3. Selecione os eventos

Escolha quais eventos deseja receber e clique em Salvar.

Eventos Disponíveis

Evento	Descrição
MESSAGE_SENT	Mensagem enviada pela equipe
MESSAGE_RECEIVED	Mensagem recebida do contato
CHAT_CREATED	Nova conversa criada
CHAT_ENDED	Conversa finalizada
CHAT_TRANSFERRED	Conversa transferida
CHANNEL_CONNECTED	Canal conectado
CHANNEL_DISCONNECTED	Canal desconectado

Veja a lista detalhada e exemplos de payload em Eventos.

Requisitos da URL

• Usar HTTPS
• Ser publicamente acessível
• Aceitar requisições POST
• Responder com status 200

Tentativas

Se a URL não responder com sucesso, o MeChat faz novas tentativas:

Config	Valor
Timeout	30 segundos
Tentativas	3
Intervalos	1 min, 5 min, 15 min

Validando a Origem

Se você definiu uma Secret Key, use-a para validar que a requisição veio do MeChat. A chave é enviada no header X-Webhook-Secret.

Próximos Passos

• Eventos - Lista de eventos e exemplos de payload
• Práticas Recomendadas - Dicas para implementação