Integrações e API
Ligue o Dialogix aos sistemas que a sua empresa já usa.
Envie mensagens e grave contatos e oportunidades pela API, inicie fluxos por webhook, conecte o n8n, devolva as vendas para os anúncios da Meta e dê ao agente acesso à Google Agenda e às Planilhas.
- API e webhooks a partir do plano Professional
- Spec OpenAPI 3.0
- Credenciais criptografadas
O que resolve
Quando o WhatsApp não conversa com o resto da empresa.
Sistema que não avisa o cliente
Pedido aprovado, fatura vencendo, formulário do site: o seu sistema chama o Dialogix e a mensagem sai pelo WhatsApp.
Anúncio que só traz conversa
A Meta só sabe que a conversa começou. Devolvendo quem virou lead e quem comprou, o anúncio passa a buscar quem compra.
Cadastro digitado duas vezes
Contatos e oportunidades criados e atualizados pela API, a partir do seu ERP ou da sua loja.
Como funciona
Do token à primeira mensagem enviada.
Gere os tokens
O token do canal decide por qual número a mensagem sai; o token da empresa dá acesso à API de CRM.
Teste na própria tela
Os formulários de teste enviam texto e mídia sem sair da tela da API.
Integre
Use a spec OpenAPI 3.0 no Postman ou no Insomnia, com todos os campos de cada recurso.
Automatize
Combine com o Construtor de Fluxos, o n8n e as ferramentas do agente de IA.
Recursos
Integrações prontas, sem projeto de TI.
Meta Ads
Resultados para o Facebook: a venda volta para o anúncio.
O Dialogix guarda sozinho o clique do anúncio de WhatsApp e avisa a Meta, pela API de Conversões, quando a conversa vira lead qualificado ou venda.
- Etiqueta vira evento
- Você liga etiquetas a eventos (ex.: "Fechado" = Comprar). Quem aplica a etiqueta, pessoa, agente ou fluxo, dispara o evento.
- Venda com valor
- Na compra, vai junto o valor do negócio ganho no Comercial.
- Leads por anúncio no Dashboard
- Chegaram, qualificaram e fecharam, por anúncio, ordenados pelos que mais fecham.
Agenda e Planilhas do Google no agente de IA.
Conecte a conta Google da empresa e cadastre as planilhas que o agente pode consultar, cada uma dizendo para que serve.
- Planilhas que o agente consulta
- O agente decide quando consultar pela descrição "Para que serve" de cada planilha.
- Tabela de preços sincronizada
- A Tabela de preços pode vir de uma planilha publicada, atualizada sozinha todo dia de manhã.
n8n e webhooks
A sua automação externa atendendo uma fila.
Cadastre um fluxo do n8n, um webhook seu ou um Typebot e ligue a uma fila. Cada mensagem do cliente vai para a sua URL enquanto nenhum atendente assumir.
- Áudio já transcrito
- Mensagem de voz chega à sua URL com a transcrição junto.
- Resposta pela API
- A sua automação responde ao cliente pela API de mensagens do Dialogix.
- Webhook que inicia fluxo
- No Construtor de Fluxos, o gatilho de webhook recebe dados do seu sistema e começa a conversa.
API externa
Uma chamada para enviar, uma API para o CRM.
Endereço base da API de CRM: https://api.dialogix.com.br/api/v1. Erros sempre no mesmo formato, com o código HTTP certo.
- Envio de mensagensTexto, mídia e mensagens ricas (botões, lista, link, código para copiar, localização, contato, cartão Pix e cobrança) pelo número que você escolher.
- API de CRMContatos e oportunidades: listar, buscar, criar e atualizar. Tickets: listar e buscar.
- Spec OpenAPI 3.0Importe no Postman ou no Insomnia com todos os campos. A tela da API tem formulários de teste de envio.
POST https://api.dialogix.com.br/api/messages/send
Authorization: Bearer <token do canal>
Content-Type: application/json
{
"number": "5511999998888",
"body": "Olá! Seu pedido saiu para entrega."
}Detalhes que importam
Integração que não vaza nem duplica.
Dois tokens, dois papéis
O token do canal só envia mensagens por aquele número. O token da empresa só acessa a API de CRM. Gerar um novo invalida o anterior na hora.
Cada empresa só vê o seu
Tudo o que é criado pela API pertence à sua empresa; o token de uma empresa nunca enxerga dados de outra.
Limite claro
API de CRM com até 300 requisições por minuto por empresa, com erro 429 explícito quando passa.
Cofre de credenciais
Chaves dos seus sistemas ficam criptografadas e são usadas pelo nome em fluxos e ferramentas do agente.
Conversão sem duplicar
Reaplicar uma etiqueta não reenvia o evento para a Meta: cada atendimento conta uma vez por tipo de evento.
Reenvio do que a Meta recusou
Corrigida a configuração, as conversões recusadas dos últimos 7 dias podem ser reenviadas, com o resultado de cada uma.
Planos
API e integrações a partir do Professional.
A API externa, os webhooks e as integrações com n8n e HTTP entram a partir deste plano. Agente de IA, fluxos e Comercial já vêm em todos.
| Recurso | Essential | Professional | Enterprise |
|---|---|---|---|
| Integrações e API | |||
| API externa, webhooks e integrações (n8n, HTTP) | Não incluso | Incluso | Incluso |
Perguntas frequentes
Dúvidas sobre Integrações e API.
Onde está a documentação da API?
Na tela da API, dentro do Dialogix, com o link para a spec OpenAPI 3.0 (importável no Postman e no Insomnia), exemplos de cada tipo de mensagem e formulários de teste.
Dá para enviar mensagens para grupos pela API?
Não. A API envia para contatos. Para grupos, use os envios programados do módulo Grupos.
Qual token eu uso em cada chamada?
O envio de mensagens usa o token do canal, definido em cada número de WhatsApp. A API de CRM (contatos, tickets e oportunidades) usa o token de API da empresa. Os dois vão no cabeçalho Authorization: Bearer.
Como funciona a integração com o n8n?
De dois jeitos: como integração de fila, em que cada mensagem do cliente é enviada à sua URL enquanto nenhum atendente assumir; ou como bloco do Construtor de Fluxos, que envia o contexto ao n8n e usa a resposta na conversa.
Toda conversa gera conversão para a Meta?
Não. Só conversas que vieram de um anúncio de clique para o WhatsApp e só quando recebem uma etiqueta ligada a um evento. Cliente que chegou por conta própria não gera evento, porque não há anúncio a quem atribuir.
Módulos relacionados
Funciona junto com
A mesma conversa e o mesmo contato passam por todos os módulos, sem copiar nada entre sistemas.
Conecte o WhatsApp ao resto da operação.
Gere o token, teste o envio na própria tela e integre pela spec OpenAPI.