Dashboard
Visão geral em tempo real
Conversas recentes
Filas
Selecione uma conversa
API
Integração com CRM e sistemas externos
API Keys
Configuração CRM
WHATSGEO_API_URL=http://SEU-IP:3000/api/ext
WHATSGEO_TOKEN=sua-api-key-aqui
Configure essas variáveis de ambiente no seu CRM.
Substitua SEU-IP pelo IP ou domínio do servidor.
Substitua SEU-IP pelo IP ou domínio do servidor.
Documentação
POST
/api/ext/send
Enviar mensagem individual
// Headers
Authorization: Bearer {API_KEY}
Content-Type: application/json
// Body
{
"body": "Mensagem de texto", // obrigatório
"number": "5511999999999", // obrigatório
"agentEmail": "agente@crm.com", // opcional — atribui conversa
"externalKey": "ID_CRM_123", // opcional — ref. do CRM
"isClosed": false // opcional — fecha conversa
}
| Campo | Tipo | Descrição |
|---|---|---|
body obrigatório | string | Texto da mensagem |
number obrigatório | string | Número com DDI (5511...) |
agentEmail opcional | string | Email do agente no CRM (campo "Email CRM" do agente) |
externalKey opcional | string | ID do registro no CRM |
isClosed opcional | boolean | Encerrar conversa após envio |
POST
/api/ext/group
Enviar mensagem ao grupo
{
"body": "Mensagem para o grupo", // obrigatório
"externalKey": "ID_CRM_123" // opcional
}
O grupo é definido pela variável
GROUP_JID no servidor. Configure em .env.
POST
/api/ext/createContact
Criar/atualizar contato
{
"number": "5511999999999", // obrigatório
"name": "João Silva", // opcional
"firstName": "João", // opcional
"lastName": "Silva", // opcional
"externalKey": "ID_CRM_123", // opcional
"email": "joao@email.com" // opcional
}
Se o número já existe, atualiza. Se não existe, cria novo contato.
Contatos
Gerencie seus contatos de WhatsApp
NomeTelefoneAniversárioNotas
Instâncias WhatsApp
Gerencie as conexões com o WhatsApp
Agentes
Atendentes e suas filas de atendimento