Skip to main content
A plataforma resolve muita coisa sem depender de terceiros. Quando é preciso trocar informação com outro sistema — trazer dados de fora ou avisar alguém lá fora —, os caminhos são estes.

​
Onde fica

Em Ajustes → Integrações, com quatro abas:

Integrações

As contas conectadas — hoje, canais de comunicação.

Aplicações

Os tokens de acesso à API.

MCP

A conexão com ChatGPT e Claude.

Webhooks

Notificações de eventos nativos da plataforma.
Ver e configurar integrações depende das permissões do grupo Integrações no papel: visualizar, criar, editar e remover integrações. Por padrão, só o papel Property recebe essas permissões. Para os demais papéis, marque-as na configuração do papel.

​
Canais de comunicação

Uma integração de comunicação conecta um número ou uma conta externa à plataforma. A partir daí, a conversa acontece dentro do projeto, em um canal — e fica registrada na empresa, não no celular de quem atendeu.

​
Conectores disponíveis

​
Criação automática de projeto

O campo Criar o projeto nesta etapa define o que acontece quando chega uma mensagem de alguém que ainda não tem projeto aberto.
Se nenhuma etapa for escolhida, mensagens de números sem projeto aberto são ignoradas. É a configuração que mais passa despercebida ao ligar um canal pela primeira vez.
O destino é uma etapa, não um funil. Isso importa porque a etapa é que carrega automações, restrições e assistentes — a mensagem que chega já cai dentro do processo.

​
Recuperar histórico

A opção Recuperar mensagens anteriores ao abrir um canal traz as últimas 10, 25, 50 ou 100 mensagens da conversa.
Disponível nos conectores Evolution e WhatsApp hospedado pela Olie. O WhatsApp Cloud (Meta) não oferece essa opção.

​
Origem de campanha

Disponível no WhatsApp Cloud (Meta). Quando alguém chega por um anúncio do Facebook ou do Instagram que abre o WhatsApp, a Meta informa de qual anúncio a conversa veio, e a integração pode guardar esses dados no projeto.
1

Escolha o formulário

Na seção Origem de campanha da integração, selecione em Formulário que recebe os dados o formulário onde os dados vão ficar. Se ainda não existe um, Criar formulário com esses campos cria um com os cinco campos já relacionados.
2

Relacione os campos

Para cada dado do anúncio — identificador do clique, ID do anúncio, tipo de origem, título e texto do anúncio — escolha o campo do formulário que o recebe, ou deixe Não gravar este campo.
Os dados chegam junto com a mensagem vinda do anúncio e são gravados como formulário avulso no projeto da conversa. Se a mesma pessoa voltar depois por outro anúncio, os dados do anúncio mais recente substituem os anteriores.
Sem formulário escolhido, a origem da campanha fica só no Registro de atividade da integração. Se a gravação no formulário falhar — por exemplo, porque um campo relacionado foi excluído —, os dados são registrados no conteúdo do projeto para não se perderem.

​
Governança

Quem atende não escolhe de qual número a resposta sai, e não vê o número do outro lado quando a configuração assim define. Vários números podem estar conectados ao mesmo tempo, cada um com o seu funil. A conversa fica registrada na empresa, e não some quando alguém sai.
Quando um projeto tem mais de um canal externo, a ação de enviar conteúdo escolhe por qual sair pela configuração da automação, não pela origem da conversa. Em funis que recebem por mais de um número, nomeie os canais e aponte cada automação para o canal certo. Ver Conteúdo do projeto.

​
Aplicações e tokens de API

Em Ajustes → Integrações → Aplicações você cria o token usado pela API.
O token é exibido uma única vez. Ao fechar a janela, não há como vê-lo de novo — só gerar outro.
As permissões de uma aplicação são de nível proprietário: o token passa por qualquer verificação de permissão da plataforma. Ele não herda o papel de ninguém e não pode ser restringido hoje.Guarde-o como você guardaria uma senha de banco de dados. Para acesso com as permissões de uma pessoa, use o MCP, que herda exatamente o que aquele usuário enxerga.

​
Webhooks

Existem dois mecanismos diferentes com o mesmo nome:
Disponível hoje. A ação Disparar webhook chama uma URL externa quando a automação roda, levando os dados do disparo e um corpo customizado que aceita sintaxe avançada.Há um botão de teste no editor. Uma falha na chamada é registrada e o fluxo continua nas ações seguintes.Ver Ações: comunicação, IA e execução.

​
A API como integração

A API cobre leitura e escrita, e é a mesma que a interface usa.
O caminho mais rápido para descobrir como fazer algo pela API é executar a ação na interface com as ferramentas de desenvolvedor do navegador abertas e observar a requisição. O que o front chama é o que você pode chamar — a diferença é que, no seu caso, a autenticação é por token fixo.
Ver Referência da API para autenticação, limites e estrutura das respostas.

​
Quando não integrar

Nem todo par de sistemas precisa de integração. Quando dois sistemas não trocam dados entre si, mas alguém quer enxergar os dois juntos, uma convenção comum — o mesmo identificador nos dois lados — mais um assistente conectado por MCP resolve sem construir nada.

​
Próximos passos

Conteúdo do projeto

Como os canais aparecem dentro do projeto.

MCP

Consultar e operar por conversa, com as suas permissões.