Integrações e canais
Uma integração é a conexão do OneTrace.pro com um serviço externo: servidor de e-mail, gateway de SMS, bot em um mensageiro, plataforma de anúncios ou armazenamento de arquivos. Os canais conectados são usados pelas jornadas e campanhas; as plataformas, pelas exportações de públicos e pelas conversões de anúncios; as fontes, pela importação de dados regular.
A seção fica no menu Engajamento → Integrações.

As integrações conectadas são agrupadas por tipo. Quando há vários tipos, aparece acima dos cartões um filtro com contadores: Todas, Canais, CRM etc.
O que pode ser conectado
Uma nova integração é conectada pelo botão Adicionar integração: na janela, os serviços são agrupados por tipo, e a busca encontra um serviço pelo nome. O botão + ao lado do título de um grupo na página abre a janela direto nesse tipo.
Canais: por eles as mensagens são enviadas.
| Canal | Como funciona |
|---|---|
| Serviço de e-mail da plataforma: envio a partir do seu domínio conectado em Domínios de envio, com assinatura DKIM, devoluções, reclamações e lista de supressão tratadas automaticamente; ou Servidor SMTP próprio: endereço, porta, criptografia, usuário e senha. Nos dois casos, você informa o endereço e o nome do remetente e pode ativar o rastreamento de aberturas e cliques. Com servidor SMTP próprio, você pode informar o domínio e a caixa de devoluções, para que e-mails não entregues cancelem a inscrição do endereço automaticamente. Os e-mails dos clientes para o endereço de suporte podem ser recebidos no chat online; veja E-mails recebidos no chat | |
| SMS | o provedor que você escolher: SMS.ru, SMSC.ru, Twilio ou a API HTTP do seu próprio gateway. Os status de entrega chegam no endereço exibido na integração |
| Telegram | bot criado no BotFather: basta o token, e o bot obtém sozinho o endereço para mensagens recebidas |
| Viber (campanhas) | mensagens por número de telefone via agregador: SMSC.ru, Infobip ou a sua própria API HTTP |
| Bot do Viber | bot do Viber pelo token do painel de parceiro, com boas-vindas para novos inscritos |
| Bot do MAX | bot do mensageiro MAX pelo token do business.max.ru, com boas-vindas e o botão “Compartilhar número”; veja Bot do MAX |
| Comunidade do VK | mensagens em nome da comunidade por chave de acesso, a partir do plano “Crescimento”; veja Comunidade do VK |
| Instagram Direct | mensagens da conta profissional do Instagram pelo seu app da Meta, a partir do plano “Crescimento”; veja Instagram Direct |
| Facebook Messenger | mensagens da página do Facebook pelo seu app da Meta, a partir do plano “Crescimento”; veja Facebook Messenger |
| WhatsApp Business Cloud API: ID do número, ID da conta, token e segredo do app Meta | |
| Web Push | notificações no navegador; as chaves são criadas automaticamente, e as inscrições são coletadas pelo código no site; veja Conexão do site |
| Push móvel | notificações no app para Android e iOS: pacote e conta de serviço do Firebase, bundle id e chave APNs; veja Apps móveis |
| Mensagens no app | janela, banner ou tela cheia dentro do app aberto; a partir do plano “Crescimento”, veja Apps móveis |
| Cartões Wallet | cartão de fidelidade no Apple Wallet e no Google Wallet: certificado Pass Type ID da Apple, Issuer ID e conta de serviço do Google; a partir do plano “Crescimento”, veja Cartões Wallet |
| Webhook | requisição ao seu servidor com os dados da mensagem, por exemplo para o seu próprio sistema de notificações |
Exportações de públicos: Webhook, S3 (CSV), Meta Custom Audience, Yandex Audiences, VK Ads e Google Ads Customer Match.
Conversões de anúncios: Meta Conversions API, conversões offline do Yandex Metrica e do Google Ads e eventos offline do VK Ads; veja Conversões de anúncios.
Fontes de dados: arquivo por URL, arquivo do S3 e Planilha do Google.
Data warehouses: S3 (NDJSON), Google Cloud Storage, BigQuery, Snowflake, ClickHouse e PostgreSQL para a exportação dos dados do projeto. O grupo fica visível no plano “Empresarial”.
CRM: amoCRM, Kommo, Bitrix24, HubSpot, Pipedrive, Zoho CRM, Odoo, Salesforce e Microsoft Dynamics 365: contatos, leads e negócios em perfis e eventos, nós de jornada para negócios e tarefas, exportação de segmentos de volta para o CRM; veja CRM. O grupo fica visível a partir do plano “Crescimento”.
Você pode conectar várias integrações do mesmo tipo: por exemplo, dois servidores SMTP para e-mails de marketing e transacionais. Nos modelos, jornadas e campanhas, você escolhe por qual integração enviar.
Como conectar uma integração
- Clique em Adicionar integração e escolha um serviço, por exemplo E-mail. À esquerda da janela ficam os tipos de integração com uma explicação e, no topo, a busca por nome.
- Defina o Nome: ele aparece nos modelos, jornadas e exportações, por exemplo “E-mail de marketing”.
- Preencha as configurações. As dicas abaixo dos campos explicam onde obter o token ou a chave no painel do serviço.
- Clique em Salvar. Para escolher outro serviço, clique em Voltar.
- No cartão da integração, clique em Testar.


Em alguns serviços, depois de salvar, aparecem campos de sistema nas configurações, por exemplo URL do webhook e Token de verificação no WhatsApp ou URL de status de entrega no SMS. Copie-os para o painel do serviço; caso contrário, os status de entrega e as mensagens recebidas não vão chegar.
Telegram, Bot do Viber, Bot do MAX e WhatsApp recebem as mensagens no endereço da sua instalação do OneTrace.pro: ele precisa estar acessível pela internet via HTTPS.
Bot do MAX
- Crie um bot no business.max.ru — só pessoa jurídica russa, empresário individual ou autônomo pode publicar um bot — e copie o token: “Чат-боты” → ⋮ → “Настройки”.
- Clique em Adicionar integração, escolha Bot do MAX, cole o Token do bot e salve. O bot obtém sozinho o endereço para mensagens recebidas, e o nome dele aparece nas configurações.
- Se quiser, defina a Mensagem de boas-vindas e o texto do botão “Compartilhar número”: o bot envia esses textos quando o cliente o inicia.

O bot só pode escrever para quem o iniciou. O cliente é vinculado ao perfil de duas formas:
- por link: o seu servidor cria para o cliente que fez login o link
https://max.ru/{bot}?start=…(POST /api/v1/max/link, como no Telegram), e o cliente abre o bot por ele; - por número: o cliente toca no botão “Compartilhar número” na mensagem de boas-vindas. Se o MAX confirmar que o número pertence à conta dele, o bot é vinculado ao perfil com esse telefone. Um cartão de contato de outra pessoa encaminhado não é vinculado.
Iniciar o bot é uma inscrição no canal; parar o bot ou excluir a conversa é um cancelamento da inscrição. As mensagens dos clientes para o bot viram o evento max.message e, a partir do plano “Crescimento”, conversas do chat online. O MAX não envia relatórios de entrega: a mensagem aceita é considerada entregue. As regras do MAX proíbem publicidade em mensagens de serviço.
Comunidade do VK
- Na comunidade, abra Manage → Messages e ative as mensagens da comunidade.
- Em Manage → API usage → Access tokens, clique em “Create token” e marque as permissões “Community management”, “Community messages”, “Photos” e, se as regras forem responder a comentários, “Wall”.
- Clique em Adicionar integração, escolha Comunidade do VK, cole a Chave de acesso da comunidade e salve. O OneTrace.pro verifica as permissões da chave, adiciona sozinho o servidor de Callback API nas configurações da comunidade e mostra o nome e o endereço da comunidade.
- Se quiser, defina as Boas-vindas: a pessoa que permitiu as mensagens da comunidade recebe esse texto.

A comunidade só pode escrever para quem permitiu as mensagens: escreveu primeiro, tocou em “Allow messages” ou abriu um link vk.me. Isso é a inscrição no canal, e proibir as mensagens é o cancelamento da inscrição. O seu servidor pode vincular a pessoa ao perfil do cliente: POST /api/v1/vk/link cria para o cliente que fez login o link https://vk.me/{community}?ref=…, e a mesma marca pode ser passada como chave para o widget “Allow messages”.
Na mensagem, é possível enviar texto, uma imagem e botões com link. O VK não aceita imagens por URL: o OneTrace.pro envia o arquivo sozinho, uma vez por campanha. As mensagens das pessoas viram o evento vk.message e conversas do chat online, e os comentários em posts acionam as regras por palavra-chave. Excluir a integração remove também o servidor de Callback API das configurações da comunidade.
Instagram Direct
O Instagram é conectado pelo seu próprio app na Meta: para a sua própria conta, a análise do app pela Meta não é necessária.
- No Meta for Developers, crie um app, adicione o produto Instagram e, na seção Configuração da API com login do Instagram, conecte a conta profissional.
- Clique em “Gerar tokens de acesso” e copie o token. São necessárias as permissões
instagram_business_basic,instagram_business_manage_messagese, para responder comentários,instagram_business_manage_comments. Na mesma seção, copie a Chave secreta do app do Instagram. - Clique em Adicionar integração, escolha Instagram Direct, cole o token e a chave secreta e salve. Nas configurações aparecerão a URL do webhook e o Token de verificação.
- Informe a URL e o token nas configurações de webhooks do app (seção Instagram). O OneTrace.pro inscreve a conta nos eventos sozinho.

O token vale por 60 dias, e o OneTrace.pro o renova sozinho. Se não conseguir renovar, o erro aparecerá no cartão da integração: crie um novo token e salve a integração antes que o antigo expire.
O Instagram só permite escrever para uma pessoa até 24 horas após a mensagem dela. Campanhas e jornadas pulam quem escreveu antes disso: a mensagem não é enviada, e a inscrição continua. O operador do chat pode responder mais tarde, em até 7 dias, se o app tiver a permissão Human Agent e a opção Respostas de operadores até 7 dias estiver ativada na integração.
A primeira mensagem da pessoa é a inscrição no canal; “stop” é o cancelamento da inscrição. O link para a conversa com uma marca para vincular ao perfil é criado por POST /api/v1/instagram/link: https://ig.me/m/{account}?ref=…. As mensagens e as respostas a stories viram o evento instagram.message e conversas do chat online, e os comentários acionam as regras por palavra-chave.
Facebook Messenger
O Messenger é conectado pelo seu app na Meta, como o Instagram: para a sua própria página, a análise do app pela Meta não é necessária.
- No Meta for Developers, crie um app e adicione o produto Messenger.
- Na seção Messenger → Configurações da API, conecte a página do Facebook e gere um token da página com a permissão
pages_messaging. É necessário um token sem prazo de validade: o OneTrace.pro não o renova. Em Configurações do app → Básico, copie a chave secreta do app. - Clique em Adicionar integração, escolha Facebook Messenger, cole o token e a chave secreta e salve. O OneTrace.pro encontra a página, inscreve-a nas mensagens e mostra o Endereço do webhook e o Token de verificação.
- Informe o endereço e o token nas configurações de webhooks do app (seção Messenger).
O Messenger, assim como o Instagram, só permite escrever para uma pessoa até 24 horas após a mensagem dela: campanhas e jornadas pulam quem escreveu antes disso. O operador do chat pode responder em até 7 dias, se o app tiver a permissão Human Agent e a opção Respostas dos atendentes até 7 dias estiver ativada na integração.
A primeira mensagem da pessoa é a inscrição no canal e dispara a Saudação das configurações da integração; “stop” é o cancelamento da inscrição. A pessoa recebe no perfil o identificador facebook_psid — o número da conversa justamente com a sua página — e o nome do Facebook, se a página tiver acesso a ele. Mensagens, fotos e arquivos viram o evento messenger.message e conversas do chat online. Os botões de resposta rápida do operador chegam ao Messenger como botões de verdade.
E-mails recebidos no chat
Na integração de e-mail, o grupo E-mails recebidos no chat recebe no chat online os e-mails dos clientes enviados para o endereço de suporte. A resposta do operador é enviada por essa mesma integração, na mesma troca de mensagens. Formas de recebimento:
- Caixa IMAP: servidor, porta, criptografia, usuário, senha e pasta da caixa de suporte. Os e-mails novos são lidos uma vez por minuto e marcados como lidos.
- Webhook: depois de salvar, aparece o Endereço do webhook com um token. Informe-o no serviço de e-mail como endereço para e-mails recebidos. Funcionam: Postmark — Inbound webhook; SendGrid — Inbound Parse, com ou sem “POST the raw, full MIME message”; Mailgun — Routes com a ação forward; Cloudflare Email Workers — com o envio do e-mail completo. O token no endereço é secreto: não publique o endereço. Se o endereço pode ter vazado, marque Alterar o endereço do webhook e salve: aparece um novo endereço e o antigo deixa de aceitar e-mails. Só quem pode gerenciar a integração vê o endereço.
O Endereço de suporte é obrigatório nas duas formas: é para ele que os clientes escrevem, e ele também é o endereço de resposta nos e-mails dos operadores.
Teste e status
O botão Testar se conecta ao serviço e mostra o resultado: “A conexão funciona”, com detalhes (nome do bot, saldo no provedor de SMS, bucket disponível), ou “O teste falhou”, com o texto do erro. O horário do último teste aparece no cartão.
| Status | O que significa |
|---|---|
| Ativa | a conexão está em ordem |
| Erro | o último teste ou a configuração falhou; o texto do erro aparece no cartão. Corrija as configurações e teste novamente |
| Desativada | a integração foi desligada pelo interruptor Ativada nas configurações; nenhuma mensagem é enviada por ela |
O teste de SMS pela sua própria API HTTP apenas verifica se o endereço do gateway está acessível: um SMS real é pago, então confira o envio com uma mensagem de teste a partir do modelo.
Edição e exclusão
- Editar abre as configurações. Senhas, tokens e chaves não são exibidos depois de salvos: deixe esse campo vazio para manter o valor anterior.
- Para interromper o envio temporariamente, desligue o interruptor Ativada; as configurações são mantidas.
- Excluir integração: as mensagens deixam de ser enviadas por ela, e as exportações e fontes que usam essa conexão param com erro. Nos bots do Telegram, do Viber e do MAX e no SMS.ru, a plataforma remove o próprio webhook. Se o serviço estiver indisponível, você verá um aviso — remova o webhook manualmente nas configurações do bot ou na conta do serviço.
Quem pode gerenciar integrações
| Ação | Funções |
|---|---|
| Ver integrações | “Proprietário”, “Administrador”, “Gerente” |
| Conectar, alterar, testar e excluir | “Proprietário”, “Administrador” |
A função de um membro pode ser limitada a integrações específicas; veja Membros e funções. Esse membro vê na seção apenas as suas integrações e só pode gerenciá-las se a função permitir. Ele não pode conectar uma nova integração: para isso, é preciso ter permissão no projeto inteiro. Nos editores de modelos e de jornadas, ele continua escolhendo a integração entre todas as conectadas no projeto.
O que é importante saber
- Os canais não verificam inscrições nem frequência por conta própria: essas regras são comuns a todos os canais e ficam na página Regras de mensagens.
- Lá você também pode desativar uma extensão desnecessária, por exemplo o WhatsApp. A extensão desativada some das integrações, dos modelos e das jornadas do projeto.
- No WhatsApp, a primeira mensagem e as campanhas só são possíveis com modelos aprovados pela Meta; texto livre, apenas em até 24 horas após uma mensagem do cliente. Modelos da Meta, carrosséis de produtos e formulários do WhatsApp estão no artigo Compras no WhatsApp.
- Com o serviço de e-mail da plataforma, você adiciona os registros DKIM, SPF e de devoluções uma única vez, ao conectar o domínio; veja Domínios de envio. Com servidor SMTP próprio, SPF, DKIM e DMARC são configurados no servidor e no seu domínio.