Visualize na Atom o funil completo das suas vendas 📊

❓ Por que é importante ver o funil completo de vendas na Atom?

Em muitos setores (automotivo, imobiliário, educação, etc.), o fechamento da venda ocorre fora da Atom, já que, depois que o Agente de IA qualifica o cliente reunindo todas as informações necessárias e agenda um encontro com um consultor comercial (passando pelas etapas de Lead, MQL e SQL), o cliente precisa comparecer à filial correspondente para formalizar a compra. Esse fechamento, na maioria das vezes, é registrado apenas pelo consultor que atendeu o cliente presencialmente no CRM da empresa.

Isso gerava uma perda de visibilidade nas etapas finais do funil de vendas, como:

• Opportunity
• Customer (venda concluída)

Com essa nova funcionalidade, agora você pode visualizar na Atom o ciclo completo de vendas, desde o primeiro contato até o fechamento da venda.

🔍 Quais benefícios essa funcionalidade oferece?

Ao sincronizar as etapas finais do processo comercial do seu CRM com a Atom, você poderá:

• Visualizar o funil completo de vendas em um único lugar.
• Medir quantos contatos realmente se convertem em vendas.
• Comparar resultados antes e depois de utilizar a Atom.
• Identificar pontos de fuga no processo comercial.
• Tomar melhores decisões para otimizar bots, fluxos e o atendimento comercial em geral.
• Criar campanhas com foco na etapa atual do contato.

🛠️ Como configurar a visualização do funil completo de vendas na Atom?

Existem dois cenários possíveis:

🔹 Opção 1: Configuração com HubSpot (integração nativa)

Se você utiliza o HubSpot, esta é a forma mais simples de configurar o funil completo.

Passo a passo

1. Acesse a Atom
2. Vá até Integrações
3. Selecione HubSpot e clique nos três pontos
4. Clique em Configuração
5. Clique em Configuração do Lifecycle Stage do HubSpot

A Atom listará automaticamente as etapas do ciclo de vida do contato configuradas no HubSpot.

Faça o mapeamento um a um entre:

• Etapas do Lifecycle no HubSpot

• Etapas (do componente Etapa do Cliente do Flowbuilder) no Atom:

  Awareness, Lead, MQL, SQL, Opportunity, Customer

Ao clicar no ícone de lápis em Ações, você poderá selecionar a etapa correspondente para realizar o mapeamento.

1. Clique em Salvar para finalizar a configuração.

---

🔹 Opção 2: Tenho um CRM diferente do HubSpot

Se você utiliza outro CRM (Salesforce, Dynamics ou qualquer outro), também é possível visualizar o funil completo de vendas na Atom.

Como funciona?

A Atom disponibiliza um endpoint HTTP que permite receber atualizações de etapas a partir de qualquer CRM que suporte automações.

📌 Informações necessárias para o endpoint

Método HTTP

POST

URL

https://us-central1-atomchat-io.cloudfunctions.net/conversations/updateLeadStageByPhone

Headers

KEY	Valor
Content-Type	application/json
Authorization	Bearer {token da sua empresa no Atom}

Body da requisição

{
  "phone": "valor",
  "leadStage": {
    "key": "valor"
  }
}

Parâmetros do body

Parâmetro	Tipo	Descrição	Valores válidos
phone	String	Obrigatório. Telefone do contato com código do país.	Não deve conter espaços, hífens ou caracteres não numéricos. Ex.: 551122334455
leadStage	Object	Obrigatório. Objeto que contém a nova etapa do ciclo de vida.
key	String	Obrigatório. Chave que representa a nova etapa.	awareness, lead, mql, sql, closure, customer

Keywords de acordo com a etapa na Atom

Keywords	Etapa na Atom (componente Etapa do Cliente do Flowbuilder)
awareness	Awareness
lead	Lead
mql	MQL (Marketing Qualified Lead)
sql	SQL (Sales Qualified Lead)
closure	Opportunity
customer	Customer

Exemplo de requisição (cURL)

curl --location --request PATCH '<https://us-central1-atomchat-io.cloudfunctions.net/conversations/updateLeadStageByPhone>' \\
--header 'Content-Type: application/json' \\
--header 'Authorization: Bearer ***' \\
--data '{
  "phone": "551122334455",
  "leadStage": {
    "key": "customer"
  }
}'

Respostas

Código	Descrição
200 OK	A atualização foi realizada com sucesso. O corpo da resposta pode conter o objeto da conversa atualizado.
400 Bad Request	A requisição foi mal formulada. Pode ocorrer se o body não for um JSON válido ou se o valor de key não for permitido.
401 Unauthorized	O token de autorização não é válido ou não foi fornecido.