Este guia mostra como usar as funcionalidades da integração do Treble com o Active Campaign.
A integração do Active Campaign com o Treble permite interagir com múltiplas entidades a partir das suas conversas no Treble. As entidades disponíveis para interagir com a integração são: Contato, Negócio (Deal / Oportunidade) e Pipeline.Com essas entidades, as ferramentas da integração permitem executar diferentes ações de acordo com o tipo de entidade. Em Contato e Negócio (Deal / Oportunidade), você pode criar, atualizar, remover, listar e consultar registros individuais. Em Pipeline, você pode consultar um, listar vários ou remover.
Como usar as ferramentas do Treble para Active Campaign?
A integração do Active Campaign com o Treble utiliza o assistente de IA “Automatizar tarefas complexas” para executar as ações das ferramentas do Treble para o Active Campaign. Para isso, é indispensável que você saiba como usar o assistente de IA “Automatizar tarefas complexas” no Treble e como configurar as ferramentas do Treble para o Active Campaign.Se você precisar de mais informações sobre como usar o assistente de IA “Automatizar tarefas complexas” no Treble, pode consultar a documentação de “Automatizar tarefas complexas” no Treble no seguinte link:
Assistente de IA Automatizar tarefas complexas no Treble
Aprenda a usar o assistente de IA “Automatizar tarefas complexas” no Treble.
Configuração das ferramentas do Treble para Active Campaign
Para configurar as ferramentas do Treble para Active Campaign, siga os passos abaixo:
Acesse a seção “AI Center” no Treble.
Crie um novo agente de IA.
Selecione a opção “Automatizar tarefas complexas”.
Na seção “Ferramentas”, selecione a ferramenta “Aplicações Conectadas”.
Na seção “Aplicações Conectadas”, selecione a aplicação “Active Campaign”.
Na seção “Ferramentas”, selecione a ferramenta “Active Campaign” que deseja configurar.
Esse processo é o mesmo para todas as ferramentas listadas do Treble para Active Campaign. No entanto, cada ferramenta tem suas próprias configurações. Explicaremos as configurações de cada ferramenta a seguir.
Dentro das ferramentas listadas do Treble para Active Campaign, existe a ferramenta “Buscar Contato por Telefone”. Essa ferramenta permite buscar Contatos por telefone. A ferramenta busca automaticamente o Contato no Active Campaign de acordo com o telefone de WhatsApp do cliente que está interagindo com seu assistente de IA por meio de uma linha de WhatsApp conectada ao Treble. Não é necessário que seu assistente de IA pergunte o telefone do cliente, a ferramenta fará isso automaticamente.Clique na opção de buscar Contato por telefone. Depois de clicar, esta ferramenta não tem mais configurações. Nos dois próximos passos, clique em “Próximo Passo” e finalmente clique em “Salvar Configuração”. Você verá a ferramenta adicionada dentro das instruções do seu assistente de IA.
Formato do telefone no Active Campaign e propriedades
O Treble utiliza o formato de telefone internacional para buscar Contatos no Active Campaign. Por exemplo, se o telefone do cliente for dos Estados Unidos e o número for (917) 555-0111, o Treble fará a busca no Active Campaign como +19175550111. O Treble fará a busca dentro da propriedade Phone.Tenha em conta que, no final, é o agente de IA quem decide em qual formato realizar a busca. Por padrão, o agente tentará buscar no formato internacional. Porém, se no seu Active Campaign os telefones não estiverem salvos em formato internacional, você pode indicar ao agente dentro das instruções (prompt) qual formato deve usar para fazer a busca.Exemplos de instruções para o agente de IA:
Colômbia: “Quando usar a ferramenta de buscar Contato por telefone, busque primeiro no formato local da Colômbia (por exemplo, 3001234567) e, se não encontrar resultados, tente no formato internacional (+573001234567).”
Argentina: “Quando buscar por telefone no Active Campaign, priorize formato local da Argentina (por exemplo, 1151234567 ou 3515123456). Se não houver coincidências, tente formato internacional (+541151234567 ou +543515123456).”
Brasil: “Para buscar Contatos por telefone, use primeiro formato local do Brasil (por exemplo, 11987654321). Se não houver resultados, tente também formato internacional (+5511987654321).”
Para as demais ferramentas, como Criar Contato, Atualizar Contato, Criar Negócio, Buscar (Get) um Pipeline, etc., essas ferramentas possuem opções de configuração. Essas opções de configuração permitem interagir com propriedades dessas entidades. Essas propriedades podem ser padrão ou personalizadas. Vamos ver alguns exemplos de configurações de ferramentas.
A ferramenta “Criar Contato” permite criar um novo contato no Active Campaign. Para configurar essa ferramenta, você deve seguir os seguintes passos:
Ative a visualização das ferramentas do Active Campaign dentro da seção “Ferramentas” do seu assistente de IA.
Clique na ferramenta “Create CRM Contact”.
Nesta visualização selecione as propriedades que deseja configurar para o contato. Você pode selecionar propriedades padrão ou personalizadas. Neste exemplo, vamos selecionar as propriedades “Name”, “Emails”, “Telephone” e “Metadata”.
Clique em “Próximo Passo”. Na visualização “Parâmetros gerenciados por Agente IA” você deve selecionar quais propriedades deseja que o agente de IA complete dinamicamente durante a conversa.Quando uma propriedade está marcada como “gerenciada por Agente IA”, o agente tentará extrair esse valor do contexto do chat (por exemplo, nome, e-mail ou telefone). Se não encontrar o dado com clareza suficiente, fará uma pergunta ao cliente para completá-lo antes de executar a ferramenta.Para obter melhores resultados, defina instruções explícitas no prompt do agente sobre quais campos ele deve coletar e como deve fazê-lo. Exemplo recomendado: “Quando usar a ferramenta Criar Contato, tente extrair Name, Emails e Telephone do contexto da conversa. Se faltar algum, solicite ao cliente de forma breve e depois crie o Contato.”Nesta visualização marque apenas os campos variáveis. Os campos que você quiser fixar com um valor predefinido (por exemplo, Metadata = Novo) pode deixar sem selecionar aqui e configurar na próxima seção.Neste caso vamos selecionar as propriedades “Name”, “Emails” e “Telephone”. (Deixamos sem selecionar a propriedade “Metadata” para configurá-la na próxima seção.)
Na próxima visualização, vamos configurar os campos onde o Contato deve ser criado com algumas propriedades predefinidas. Por exemplo, se você quiser que o contato seja criado com o status “Novo”, vamos escrever no campo “Metadata” o valor “Novo”. Você pode configurar isso com múltiplas propriedades, ou seja, pode configurar várias propriedades com um valor predefinido; o importante é não selecioná-las dentro da visualização “Parâmetros gerenciados por Agente IA”.
Parabéns! Você já configurou a ferramenta Criar Contato.
Este exemplo de configuração da ferramenta Criar Contato e de seus parâmetros se aplica de forma idêntica às demais ferramentas do Active Campaign e às suas opções de configuração. A lógica é a mesma: definir quais propriedades são preenchidas com dados extraídos pelo agente de IA, quais ficam como valores predefinidos e como a ação é executada de acordo com a entidade. Isso se aplica em casos como List Pipeline, Get Contact e Update Deal, entre outros.
