Skip to main content
Esta página mostra os caminhos para trocar informação entre a Olie e outros sistemas: trazer dados de fora ou avisar alguém lá fora. Ela serve a quem administra a conta e configura os canais, e a quem desenvolve integrações pela API.

​
Onde fica

No menu de Ajustes, o grupo Integrações tem dois itens: Integrações e API. A tela API reúne as abas Aplicações, Webhooks e MCP.
Menu lateral de Ajustes com o grupo Integrações contornado, contendo os itens Aplicações, Webhooks, MCP e Integrações

O grupo Integrações no menu de Ajustes

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

A plataforma oferece três conectores de WhatsApp. A última coluna mostra o valor do campo type usado pela API. O WhatsApp hospedado pela Olie não pode ser criado pela API. Ele nasce só pelo fluxo de conexão da plataforma, que aloca o servidor e gera as credenciais da instância. Uma criação com type: whatsapp_evolution_managed é recusada. O token de uma aplicação só lista as integrações e consulta os registros delas. Criar, editar e excluir uma integração é reservado a pessoas: com token de aplicação, essas chamadas respondem HTTP 403 com message: "access_denied_for_applications".
O tipo não muda depois de criada a integração. Credenciais e configurações são específicas de cada conector, e trocar o tipo invalidaria o que já está gravado — uma atualização com um type diferente do atual é recusada. Para mudar de conector, crie uma nova integração.

​
Acompanhar a integração

Na lista e nos detalhes de cada integração, dois indicadores mostram coisas diferentes: Os dois indicadores são independentes: uma integração Ativa pode estar com a sessão Desconectada. Nos detalhes da integração, a sessão mostra também há quanto tempo está no estado atual. O Registro de atividade, nas ações da integração, mostra o que aconteceu nos últimos 30 dias: mensagens recebidas e enviadas, falhas e eventos de conexão. Os eventos ligados a um contato mostram o número dele. Em conversas de grupo, aparece o identificador do grupo no lugar do número. São eles:
  • Mensagem recebida e Mensagem enviada;
  • O provedor recusou o envio e O provedor não entregou a mensagem;
  • Contato veio de um anúncio;
  • Mensagem repetida ignorada;
  • Envio não realizado, quando falta o conector.

​
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. Ele fica na seção Criação automática de projetos da integração. Para abrir essa seção, clique em ⋮ > Editar na integração.
Seção Criação automática de projetos da edição de uma integração, com o campo Criar o projeto nesta etapa contornado e preenchido com Não criar projeto automaticamente

Com Não criar projeto automaticamente, mensagens de números novos são ignoradas

Na lista de integrações, cada conta mostra Não cria projetos ou a etapa em que cria. 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.
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.

​
Recuperar histórico

A opção Recuperar mensagens anteriores ao abrir um canal traz as últimas 10, 25, 50 ou 100 mensagens da conversa. Ela existe 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). Alguém pode chegar ao WhatsApp por um anúncio do Facebook ou do Instagram. Nesse caso, 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

A integração recebe cinco dados do anúncio: identificador do clique, ID do anúncio, tipo de origem, título e texto do anúncio. Para cada um, 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.

​
Enviar mensagem ao cliente pela API

Para mandar uma mensagem pelo WhatsApp de um projeto, grave um conteúdo no canal externo dele. A plataforma entrega o conteúdo pela integração ligada ao canal.
1

Encontre o canal do projeto

Chame GET /api/management/channels?project_id={id}. O canal externo é o que tem integration_id preenchido. Ele precisa estar com is_active igual a true.
2

Grave a mensagem no canal

Chame POST /api/management/save-media com type igual a 1 (texto) e o channel_id do canal:
3

Confira a entrega

Chame POST /api/management/projects/{id}/media com o mesmo channel_id no corpo. Nesse endpoint, o campo direction do corpo define a ordem da lista (asc ou desc). Ele não filtra a direção da mensagem.
O envio é assíncrono: a resposta de save-media confirma que o conteúdo foi gravado, não que chegou ao cliente. Cada conteúdo do canal traz estes campos sobre a entrega: A requisição é recusada com HTTP 422 em dois casos: o canal está inativo ou pertence a outro projeto.
Prefira channel_id a channel_name. O channel_name procura no projeto um canal com aquele nome. Se nenhum existir, ele cria um canal interno com esse nome, e a mensagem não sai da plataforma.

​
Aplicações e tokens de API

Em Ajustes → Integrações → API, na aba Aplicações, você cria o token usado pela API. Dois cuidados valem para todo token.
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 a interface 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. Às vezes, dois sistemas não trocam dados entre si, mas alguém quer enxergar os dois juntos. Nesse caso, uma convenção comum, como o mesmo identificador nos dois lados, somada a 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.