Toolzz: por que empresas varejistas escolhem em 2026

Lucas (CEO Toolzz)
18 de abril de 2026

O setor varejista enfrenta desafios constantes para oferecer um atendimento ao cliente eficiente e personalizado em meio a um volume crescente de interações. A capacidade de responder rapidamente às dúvidas, resolver problemas e fornecer informações precisas é crucial para a satisfação do cliente e a fidelização. A integração de sistemas e a automação de processos são elementos-chave para otimizar o atendimento e reduzir custos. Este artigo demonstra como a API do Toolzz Chat pode ser utilizada para automatizar a importação de contatos de um CRM externo, agilizando o atendimento e permitindo um suporte mais direcionado.

Pré-requisitos

Para acompanhar este tutorial, você precisará de:

• Uma conta ativa na Toolzz Chat (https://chat.toolzz.ai).

• Um token de API válido. Para obter o token, faça login na Toolzz Chat, acesse as configurações da API e gere um novo token.

  Obtendo o Token de API:

  1. Acesse https://chat.toolzz.ai e faça login.
  2. No menu lateral, clique em "Configurações".
  3. Selecione "API" na aba de configurações.
  4. Clique em "Gerar Token".
  5. Copie o token gerado e guarde-o em um local seguro.

• Conhecimento básico de programação em Python ou outra linguagem de sua preferência.

• Um ambiente de desenvolvimento configurado (ex: VS Code, Jupyter Notebook).

Arquitetura

O fluxo de integração será o seguinte:

1. Cliente: Inicia uma conversa através do WhatsApp ou Instagram.
2. WhatsApp/Instagram: Encaminha a mensagem para a Toolzz Chat.
3. Toolzz Chat: Recebe a mensagem e utiliza a API para buscar informações do cliente no CRM externo.
4. Automação: A Toolzz Chat, usando as informações do CRM, direciona a conversa para o agente mais adequado ou fornece uma resposta automatizada.
5. Agente Humano/IA: Atende o cliente com o contexto completo, assegurando um atendimento personalizado e eficiente.

Configuração no produto

Primeiramente, configure a integração do WhatsApp ou Instagram com a Toolzz Chat. Isso pode ser feito na seção "Canais" da plataforma. Certifique-se de que o canal esteja ativo e configurado corretamente para receber mensagens.

Em seguida, crie um novo agente ou utilize um agente existente para receber as conversas. Configure as permissões do agente para acessar as informações do cliente importadas do CRM.

Implementação via API

Neste tutorial, vamos focar na importação de contatos do CRM para a Toolzz Chat utilizando a API. Utilizaremos os endpoints Import Contact, Create Contact e Update Contact.

1. Import Contact

Este endpoint permite importar um lote de contatos de um arquivo CSV ou JSON.

• URL: /v1/contacts/import

• Método HTTP: POST

• Headers:

  • Authorization: Bearer <seu_token_de_api>
  • Content-Type: multipart/form-data

• Body:

  { "file": "arquivo_com_contatos.csv" }

• Parâmetros:

  Parâmetro	Tipo	Descrição	Obrigatório	Exemplo
  file	file	Arquivo CSV ou JSON com os contatos	Sim	arquivo_contatos.csv

• Response:

  { "status": "success", "message": "Contatos importados com sucesso", "imported_count": 100, "failed_count": 0 }

• URL: /v1/contacts

• Método HTTP: POST

• Headers:

  • Authorization: Bearer <seu_token_de_api>
  • Content-Type: application/json

• Body:

  { "name": "João da Silva", "email": "[email protected]", "phone": "5511999999999", "custom_attributes": { "crm_id": "12345", "last_purchase": "2024-10-26" } }

• Parâmetros:

  Parâmetro	Tipo	Descrição	Obrigatório	Exemplo
  name	string	Nome do contato	Sim	João da Silva
  email	string	Email do contato	Não	[email protected]
  phone	string	Telefone do contato	Sim	5511999999999
  custom_attributes	object	Atributos personalizados	Não	{"crm_id": "12345"}

• Response:

  { "id": "654321", "name": "João da Silva", "email": "[email protected]", "phone": "5511999999999", "created_at": "2024-10-27T10:00:00Z" }

• URL: /v1/contacts/{contact_id}

• Método HTTP: PUT

• Headers:

  • Authorization: Bearer <seu_token_de_api>
  • Content-Type: application/json

• Body:

  { "email": "[email protected]" }

• Parâmetros:

  Parâmetro	Tipo	Descrição	Obrigatório	Exemplo
  contact_id	string	ID do contato a atualizar	Sim	654321
  email	string	Email do contato	Não	[email protected]

• Response:

  { "id": "654321", "name": "João da Silva", "email": "[email protected]", "phone": "5511999999999", "updated_at": "2024-10-27T11:00:00Z" }