Anatomia da Integração CRM: Entendendo Cada Componente em 2026

Lucas (CEO Toolzz)
16 de abril de 2026

Chatbots visuais transformaram a forma como as empresas interagem com seus clientes. No entanto, o verdadeiro potencial é desbloqueado quando esses bots são integrados a sistemas de CRM, permitindo uma visão unificada do cliente e automatizando processos de vendas e suporte. Neste artigo, exploraremos como usar a API do Toolzz Bots para integrar chatbots a um CRM externo, otimizando a coleta e o uso de dados.

Pré-requisitos

Antes de começar, você precisará dos seguintes itens:

• Uma conta ativa na Toolzz Bots. Se ainda não tiver, crie uma em bots.toolzz.ai.
• Um workspace configurado dentro da Toolzz Bots.
• Um API token válido para acessar a API. Você pode encontrar seu token na seção de configurações do seu workspace.
• Familiaridade básica com APIs REST e o uso de ferramentas como curl, Postman ou Insomnia para fazer requisições HTTP.

Arquitetura da Integração

O fluxo de integração entre um chatbot da Toolzz Bots e um CRM externo envolve os seguintes componentes:

1. Usuário: Inicia a interação através de um canal de comunicação (WhatsApp, website, etc.).
2. Canal: Plataforma onde o usuário interage com o chatbot.
3. Toolzz Bot: Chatbot visual criado na plataforma Toolzz Bots, responsável por conduzir a conversa.
4. Lógica Visual: Fluxo de conversa definido visualmente, que coleta informações do usuário.
5. Resultado: Dados coletados pelo chatbot, que serão enviados ao CRM.
6. Integração: Processo de envio dos dados para o CRM externo através da API da Toolzz Bots.

Configuração do Fluxo no Toolzz Bots

Para configurar o fluxo de conversa no Toolzz Bots, siga estas etapas:

1. Acesse a plataforma Toolzz Bots e faça login.
2. Crie um novo bot ou edite um bot existente.
3. Utilize a interface visual para definir o fluxo de conversa, incluindo as perguntas que serão feitas ao usuário.
4. Adicione um nó de integração para enviar os dados coletados para o seu CRM. Este nó pode ser configurado para enviar os dados via webhook ou através da API.
5. Configure as variáveis que serão enviadas para o CRM, mapeando-as para os campos correspondentes no seu sistema.

Simplifique a integração do seu CRM. Conheça a Toolzz e veja como podemos otimizar seus processos de vendas e suporte.

Implementação via API

A API do Toolzz Bots oferece diversos endpoints para gerenciar bots e acessar os resultados das conversas. Nesta seção, vamos explorar os endpoints relevantes para a integração com um CRM externo.

1. Listando Resultados do Bot

Este endpoint permite listar os resultados de um bot específico.

• URL: https://api.toolzz.com.br/bots/results

• Método: GET

• Headers:

  { "Authorization": "Bearer YOUR_API_TOKEN" }

• Parâmetros:

  Parâmetro	Tipo	Descrição
  bot_id	String	ID do bot cujos resultados serão listados.
  page	Integer	Número da página de resultados a ser retornada (opcional).
  page_size	Integer	Número de resultados por página (opcional).

• Exemplo de Requisição (bash):

  bash curl -X GET
  'https://api.toolzz.com.br/bots/results?bot_id=YOUR_BOT_ID' -H 'Authorization: Bearer YOUR_API_TOKEN'

• Exemplo de Response JSON:

  { "results": [ { "id": "result_id_1", "bot_id": "YOUR_BOT_ID", "data": { "name": "John Doe", "email": "[email protected]", "phone": "+5511999999999" }, "created_at": "2024-01-01T10:00:00Z" }, { "id": "result_id_2", "bot_id": "YOUR_BOT_ID", "data": { "name": "Jane Smith", "email": "[email protected]", "phone": "+5521988888888" }, "created_at": "2024-01-01T11:00:00Z" } ], "total": 2, "page": 1, "page_size": 20 }

• URL: https://api.toolzz.com.br/bots/results/{result_id}

• Método: GET

• Headers:

  { "Authorization": "Bearer YOUR_API_TOKEN" }

• Parâmetros:

  Parâmetro	Tipo	Descrição
  result_id	String	ID do resultado a ser obtido.

• Exemplo de Requisição (bash):

  bash curl -X GET
  'https://api.toolzz.com.br/bots/results/result_id_1' -H 'Authorization: Bearer YOUR_API_TOKEN'

• Exemplo de Response JSON:

  { "id": "result_id_1", "bot_id": "YOUR_BOT_ID", "data": { "name": "John Doe", "email": "[email protected]", "phone": "+5511999999999" }, "created_at": "2024-01-01T10:00:00Z" }

• URL: https://api.toolzz.com.br/bots/results/{result_id}/logs

• Método: GET

• Headers:

  { "Authorization": "Bearer YOUR_API_TOKEN" }

• Parâmetros:

  Parâmetro	Tipo	Descrição
  result_id	String	ID do resultado cujos logs serão listados.

• Exemplo de Requisição (bash):

  bash curl -X GET
  'https://api.toolzz.com.br/bots/results/result_id_1/logs' -H 'Authorization: Bearer YOUR_API_TOKEN'

• Exemplo de Response JSON:

  { "logs": [ { "timestamp": "2024-01-01T10:00:00Z", "message": "User started the conversation" }, { "timestamp": "2024-01-01T10:00:10Z", "message": "User provided name: John Doe" } ] }

return response.json()