> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olie.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Integrações
> Como informação entra e sai da plataforma: canais de comunicação, aplicações, webhooks e a API
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:
As contas conectadas — hoje, canais de comunicação.
Os tokens de acesso à [API](/api-reference/introduction).
A conexão com ChatGPT e Claude.
Notificações de eventos nativos da plataforma.
Ver e configurar integrações depende das permissões do grupo **Integrações** no [papel](/guides/users/roles-permissions): 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
| Conector | Como conecta |
| -------------------------------- | ------------------------------------------------------------------------------------ |
| **WhatsApp Cloud (Meta)** | Credenciais da API oficial: Phone Number ID, Access Token, App Secret e Verify Token |
| **Evolution** | Servidor próprio: API Key, instância e endereço do servidor |
| **WhatsApp hospedado pela Olie** | Leitura de QR Code, sem infraestrutura própria |
### 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.
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.
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](/guides/forms/loose-forms) 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](/guides/content/overview).
## Aplicações e tokens de API
Em **Ajustes → Integrações → Aplicações** você cria o token usado pela [API](/api-reference/introduction/authentication).
**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](/guides/mcp/overview), 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](/guides/advanced/advanced-syntax).
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](/guides/automation/actions-integrations).
**Em breve.** A aba Webhooks existe e está marcada como tal.
São eventos que nenhuma automação pegaria — um projeto criado sem vínculo com funil algum, um usuário novo entrando na conta.
Enquanto isso, o caminho para reagir a esses casos é consultar a API periodicamente, ou desenhar o fluxo de modo que o evento passe por uma etapa.
## 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](/api-reference/introduction) 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](/guides/mcp/overview) resolve sem construir nada.
## Próximos passos
Como os canais aparecem dentro do projeto.
Consultar e operar por conversa, com as suas permissões.