A conexão com o ActiveCampaign usa a URL da API e a chave de API da sua conta, que ficam lado a lado em Settings → Developer, no painel do ActiveCampaign. Você copia os dois valores e cola na Toca.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
Antes de começar
- A chave de API é de cada usuário do ActiveCampaign: a Toca enxerga o que esse usuário enxerga. Pegue a chave com o usuário que a Toca vai usar.
- Use um usuário com acesso a contatos, negócios e campanhas. Um usuário sem a permissão de negócios (Deals), por exemplo, recebe acesso negado nas consultas de negócio.
Passo a passo
- No ActiveCampaign, abra
Settings → Developer. - Copie a URL da API (no formato
https://suaconta.api-us1.com) e a chave de API. Copie a URL dessa tela em vez de digitar: ela muda de conta para conta. - Acesse
Configurações → Integraçõesna Toca. - Localize o card ActiveCampaign e clique em Conectar.
- Cole a URL no campo URL da API e a chave no campo Chave de API.
- Clique em Salvar. O card fica marcado como conectado.
O que a Toca acessa
Com a conexão ativa, a Toca lê contatos, listas, tags, campos e segmentos; negócios, funis, etapas e tarefas; campanhas de e-mail com aberturas e cliques; automações; contas (empresas); pedidos e clientes de e-commerce sincronizados; formulários; e os disparos de SMS e WhatsApp. Pedido e faturamento da loja vêm da sua plataforma de e-commerce: no ActiveCampaign, a Toca vê só o que a loja sincronizou com ele.
A Toca também altera: cria e edita contatos, aplica e tira tags, inscreve e descadastra de listas, coloca e tira contatos de automações; cria e edita negócios e tarefas; cria, envia e pausa campanhas; dispara SMS e mensagens de WhatsApp; ajusta campos, formulários e dados de e-commerce; e exclui contatos, listas e outros cadastros. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat.
Duas atenções: e-mail, SMS e mensagem entregues não voltam; e aplicar uma tag ou inscrever um contato numa lista pode disparar automações da sua conta.
Manutenção da conexão
A chave de API não expira e não precisa de renovação: a conexão vale até alguém trocar a chave no ActiveCampaign. Nesse caso, abra o card em Configurações → Integrações pelo botão Gerenciar, cole a chave nova e clique em Atualizar. Por segurança, a chave salva aparece mascarada.
Problemas comuns
- Endereço da API recusado — a Toca só aceita a URL da API terminada em
.api-us1.com, o domínio que a documentação do ActiveCampaign publica. Copie a URL deSettings → Developersem digitar. Se a sua conta mostrar um endereço com outro domínio, fale com o suporte da Toca. - Acesso negado em negócios ou em outra área — a chave segue as permissões do usuário dono dela. Dê a permissão a esse usuário no ActiveCampaign ou use a chave de outro usuário. Salvar a mesma chave de novo não resolve.
- Consultas esbarram em limite — o ActiveCampaign aceita até 5 requisições por segundo por conta, então consultas grandes levam mais tempo.