Este guia mostra como usar as funcionalidades da integração do Treble com o HubSpot.
A integração do HubSpot com o Treble permite interagir com múltiplas entidades no HubSpot 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.
A integração do HubSpot com o Treble utiliza o assistente de IA “Automatizar tarefas complexas” para executar as ações das ferramentas do Treble para HubSpot. 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 HubSpot.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 HubSpot
Para configurar as ferramentas do Treble para HubSpot, 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 “HubSpot”.
Na seção “Ferramentas”, selecione a ferramenta “HubSpot” que deseja configurar.
Esse processo é o mesmo para todas as ferramentas listadas do Treble para HubSpot. 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 HubSpot, existe a ferramenta “Buscar Contato por Telefone”. Essa ferramenta permite buscar Contatos por telefone. A ferramenta busca automaticamente o Contato no HubSpot 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.
O Treble utiliza o formato de telefone internacional para buscar Contatos no HubSpot. 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 HubSpot como +19175550111. O Treble fará a busca dentro da propriedade Phone no HubSpot.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 HubSpot 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 HubSpot, 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 HubSpot. Para configurar essa ferramenta, você deve seguir os seguintes passos:
Ative a visualização das ferramentas do HubSpot 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 “Address”.
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, Address = Rua 123, Cidade) 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 “Address” para configurá-la manualmente 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 todos os seus contatos operam na mesma cidade e você deseja registrar o endereço de forma manual, pode escrever no campo “Address” o valor fixo correspondente, como Rua 123, Cidade. 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 HubSpot 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, Update Deal, entre outros.
