Integrar o Inglobe com seu CRM permite automatizar completamente seu fluxo de vendas. Neste tutorial, vou mostrar passo a passo como fazer essa integração usando nossa API REST.
Pré-requisitos
- Conta ativa no Inglobe
- API Key (encontre em Configurações > API)
- Conhecimento básico de programação
- CRM com suporte a webhooks ou API
Passo 1: Obtenha sua API Key
No painel do Inglobe, vá em Configurações > API e copie sua chave. Guarde-a em local seguro.
Passo 2: Envie sua primeira mensagem
Veja como enviar uma mensagem de texto usando a API:
POST /instance/{instanceId}/send/text
Headers: { "apikey": "sua_chave_api" }
Body: {
"number": "5537999999999",
"text": "Olá! Esta é uma mensagem de teste."
}
Headers: { "apikey": "sua_chave_api" }
Body: {
"number": "5537999999999",
"text": "Olá! Esta é uma mensagem de teste."
}
Passo 3: Configure webhooks
Para receber notificações quando mensagens chegarem:
POST /instance/{instanceId}/webhook
Body: {
"url": "https://seucrm.com/webhook/whatsapp",
"events": ["message", "message.ack"]
}
Body: {
"url": "https://seucrm.com/webhook/whatsapp",
"events": ["message", "message.ack"]
}
Passo 4: Processe as mensagens recebidas
Quando uma mensagem chegar, seu webhook receberá um payload como este:
{
"event": "message",
"instanceId": "abc123",
"data": {
"from": "5537999999999",
"message": "Quero saber mais sobre o produto",
"timestamp": 1701432000
}
}
"event": "message",
"instanceId": "abc123",
"data": {
"from": "5537999999999",
"message": "Quero saber mais sobre o produto",
"timestamp": 1701432000
}
}
💡 Dica Pro
Use filas (como RabbitMQ ou Redis) para processar webhooks de forma assíncrona. Isso evita perda de mensagens em momentos de alto volume.
Exemplo de integração com CRM
Fluxo típico de integração:
- Lead entra no CRM
- CRM chama API do Inglobe para enviar mensagem de boas-vindas
- Cliente responde no WhatsApp
- Webhook notifica o CRM
- CRM atualiza o status do lead
Endpoints mais usados
- POST /instance/create - Criar nova instância
- POST /instance/{id}/send/text - Enviar texto
- POST /instance/{id}/send/media - Enviar mídia
- GET /instance/{id}/status - Verificar status
- POST /broadcasts - Criar campanha em massa
Documentação completa da API
Acesse nossa documentação para ver todos os endpoints disponíveis.
Ver Documentação