Configuração Rápida de Webhooks

​

1) Criar webhook no painel

1. Acesse Ajustes > Integrações.
2. Abra Gerenciar Webhooks.
3. Clique em Novo Webhook.
4. Preencha:
   • Nome
   • URL de callback (https://seu-dominio.com/webhooks/gicoo)
   • Eventos (event_types)
   • Status ativo/inativo
   • Headers customizados (opcional)

​

2) Eventos suportados

• conversation.created
• conversation.assigned
• conversation.closed
• message.received
• message.sent
• card.created
• card.updated
• card.moved
• contact.created
• contact.updated
• form.submitted

​

3) Endpoint mínimo (Node.js)

const express = require('express');

const app = express();
app.use(express.json());

app.post('/webhooks/gicoo', (req, res) => {
  const { event, timestamp, company_id, data } = req.body;

  console.log('Evento:', event);
  console.log('Empresa:', company_id);
  console.log('Timestamp:', timestamp);
  console.log('Data:', data);

  // Regra importante: responder rápido
  res.status(200).json({ ok: true });
});

app.listen(3000, () => console.log('Webhook receiver ativo na porta 3000'));

​

4) Testar no painel

​

5) Checklist de produção

• HTTPS habilitado
• Timeout baixo no receiver
• Logs de sucesso/falha
• Processamento assíncrono para tarefas demoradas