Conectando a Insider One

A Insider One entra na Toca com o resultado das suas campanhas — e-mail, web push, SMS e onsite: envios, entregas, cliques, conversões e receita —, as jornadas do Architect e a ficha unificada de um cliente da base. A conexão é feita por credenciais: a Insider One gera chave de API por tipo, então a conexão pode levar até três chaves, além dos identificadores da conta.

Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação. O card aparece com o selo de homologação em Configurações → Integrações.

Antes de começar

• Anote o partner name — e, se for usar web push, também o Partner ID — em Settings › Inone Settings › Account Settings do painel da Insider One.
• Gere as chaves em Settings › Integration Settings › API Keys, escolhendo o tipo:
  • Campaign Analytics — obrigatória; é a que responde como foram as campanhas.
  • UCD — opcional; libera a ficha do cliente e a base.
  • Web Push — opcional; junto com o Partner ID, libera as estatísticas de push.
• A chave só aparece inteira na hora de criar — copie na hora. Se optar por restringir a chave por IP, o painel pede a lista de endereços antes de gerar; uma restrição de IP pode recusar as consultas da Toca, então confirme com o suporte antes de usar esse recurso.

Passo a passo

1. Acesse Configurações → Integrações na Toca.
2. Localize o card Insider One e clique em Conectar.
3. Preencha o formulário: Partner name e a chave Campaign Analytics (obrigatórios); as chaves UCD e Web Push e o Partner ID (opcionais).
4. Salve. O card fica marcado como conectado, e você pode voltar depois para acrescentar as chaves opcionais.

O que a Toca acessa

Leitura: o resultado das campanhas de e-mail, web push, SMS e onsite — envios, entregas, aberturas, cliques, conversões e receita por campanha; as jornadas do Architect, com entradas, canais, metas de conversão e receita; e, com a chave UCD, a ficha unificada de um cliente (atributos e eventos). O disparo de mensagens e o analytics de WhatsApp ficam fora desta conexão.

A Toca também sabe alterar dados: atualizações no cadastro de clientes da base — atributos, eventos, identificadores, exclusão e anonimização de perfil —, exportação da base para um webhook e web push avulso (criar rascunho, enviar, excluir). Nenhuma alteração acontece sozinha: cada uma passa por sua aprovação explícita, pedido a pedido, dentro do chat.

Manutenção da conexão

As chaves de API não expiram sozinhas: a conexão vale até uma chave ser revogada no painel da Insider One ou até você desconectar a integração na Toca. Se regenerar uma chave, atualize o valor no card. As chaves opcionais podem entrar a qualquer momento — reabra o card, preencha e salve.

Problemas comuns

• A consulta pede o id da campanha — para e-mail, SMS e onsite, a plataforma responde por campanha e não oferece uma listagem por API: o id sai da URL da campanha no painel da Insider One. Copie o id e pergunte de novo com ele.
• Acesso negado só em um tipo de consulta — quase sempre é a chave daquele tipo: ficha de cliente exige a chave UCD, estatísticas de push exigem a chave Web Push e o Partner ID. Também pode ser restrição de IP configurada na geração da chave.
• Período muito longo devolve erro — as analytics de e-mail e onsite respondem no máximo 1 ano por consulta. Parta o período em janelas de até 12 meses.
• Estatísticas de web push não respondem — além da chave Web Push, elas exigem o Partner ID preenchido no card (é o número em Account Settings, diferente do partner name).