🛠️ Tutorial 1 · Iniciante · ~30 min

Como criar um agente que responde clientes no WhatsApp

Você vai aprender a conectar o Tasklet ao WhatsApp e criar um agente que responde perguntas, envia informações e qualifica leads automaticamente. Sem você precisar estar online e sem escrever uma linha de código.

⏱️ Tempo estimado: 30 minutos 📶 Nível: Iniciante 💸 Custo: Gratuito para começar

⚠️ Antes de começar: seja honesto com você mesmo

O WhatsApp é a ferramenta de comunicação mais usada no Brasil, mas automatizá-lo tem suas particularidades. O Meta (empresa do WhatsApp) não quer que bots substituam pessoas de forma abusiva. Existem dois caminhos legais para conectar um agente, e cada um tem regras diferentes. Este tutorial explica os dois com clareza para você escolher o mais certo para o seu caso.

O que você vai aprender

1.Criar sua conta no Tasklet
2.Entender como o WhatsApp se conecta
3.Configurar a conexão Z-API
4.Criar o gatilho de mensagens recebidas
5.Construir o agente respondedor
6.Testar com seu próprio número
7.Ativar em produção

O que você vai precisar

🤖

Conta no Tasklet.ai

Gratuita para começar. É aqui que você vai criar e configurar o agente.

→ Criar conta grátis em tasklet.ai

📱

Um número de WhatsApp dedicado

Recomendamos usar um chip separado do seu pessoal. Pode ser um chip de R$10 de qualquer operadora. Isso evita que o bot misture com suas conversas pessoais.

🔌

Conta na Z-API (caminho mais simples)

Serviço brasileiro que conecta o WhatsApp ao Tasklet. Tem plano gratuito para testar.

→ Criar conta em z-api.io

Qual caminho de conexão usar?

Existem dois jeitos de conectar o WhatsApp ao Tasklet. Aqui está a diferença honesta:

Z-API Recomendado para começar

✅

Fácil de configurar em minutos

✅

Funciona com o WhatsApp normal do celular

✅

Plano gratuito disponível

⚠️

Não é a API oficial do Meta. Risco de ban se usado de forma abusiva (envios em massa sem permissão)

💡

Perfeito para atendimento receptivo: responder quem te manda mensagem

Meta Business API Para negócios maiores

✅

Oficial e aprovada pelo Meta

✅

Sem risco de ban

✅

Suporta alto volume de mensagens

⚠️

Configuração mais complexa (Meta Business Manager, WABA)

⚠️

Exige verificação da empresa no Meta

Este tutorial usa Z-API, o caminho mais rápido. Para a API oficial do Meta, temos um tutorial separado em breve.

Passo a passo

Crie sua conta no Tasklet

Acesse tasklet.ai e crie uma conta gratuita. O Tasklet é a plataforma onde você vai montar, configurar e rodar o seu agente. Pense nele como o "cérebro" que vai ler as mensagens que chegam e decidir o que responder.

Após criar a conta, você vai ver o painel principal com a opção de criar um novo agente. Deixe ele aberto, vamos voltar aqui no Passo 4.

Dica: use o e-mail profissional da sua empresa, não o pessoal. Facilita na hora de separar os projetos.

Crie e conecte sua instância Z-API

A Z-API funciona como uma ponte entre o WhatsApp e o Tasklet. Veja como configurar:

Acesse z-api.io e crie sua conta gratuita.
No painel da Z-API, clique em "Nova Instância" e dê um nome (ex: "Atendimento Loja").
Um QR Code vai aparecer na tela. Abra o WhatsApp no celular com o número dedicado, vá em Configurações › Dispositivos conectados › Conectar dispositivo e escaneie o QR Code.
Quando o status mudar para "Conectado", está pronto.

Importante: o celular com esse número precisa ter bateria e conexão com a internet. Sem isso, o agente não recebe as mensagens. Muita gente usa um celular antigo deixado em casa só para isso.

Anote suas credenciais da Z-API

Após conectar, você vai precisar de dois dados que ficam no painel da Z-API:

Instance ID: identifica a sua instância (ex: 3F1FCBB5942B61F5...)
Client-Token: a senha de acesso (ex: F1171b821f92c49d...)

Instance ID: 3F1FCBB5942B61F53313AAE399BC1248
Client-Token: F1171b821f92c49d2b16f329f44d450a0S

Dica: salve esses dados em um lugar seguro. Você vai precisar deles para conectar ao Tasklet.

Crie a conexão Z-API dentro do Tasklet

Agora vamos dizer ao Tasklet como falar com o seu WhatsApp:

No Tasklet, clique em "Conexões" no menu lateral.
Clique em "Nova conexão" e procure por "Z-API".
Cole o Instance ID e o Client-Token que você anotou no passo anterior.
Clique em "Testar conexão". Se aparecer uma confirmação verde, está funcionando.

Próximo passo: com a conexão criada, vamos configurar o gatilho que "acorda" o agente toda vez que uma mensagem nova chegar.

Crie o gatilho de mensagens recebidas

O gatilho é o que faz o agente entrar em ação. Sem ele, o agente fica dormindo e não faz nada. Configure assim:

No Tasklet, vá em "Gatilhos" e clique em "Novo gatilho".
Escolha a opção "Mensagem recebida no WhatsApp" (listada na seção da Z-API).
Selecione a conexão Z-API que você acabou de criar.
Dê um nome ao gatilho, como "Nova mensagem WhatsApp".
Salve e ative o gatilho. Um webhook URL vai aparecer. Copie esse endereço.
Volte ao painel da Z-API, vá em "Configurações da Instância" e cole o webhook URL no campo "Ao receber mensagem". Salve.

O que acontece agora: toda vez que alguém mandar uma mensagem para o seu número, a Z-API vai avisar o Tasklet imediatamente pelo webhook. O Tasklet vai acordar e executar o agente.

Crie e configure o agente respondedor

Agora vem a parte mais importante: dizer ao agente o que ele deve fazer quando receber uma mensagem.

No Tasklet, clique em "Novo agente" e escolha o gatilho que você acabou de criar.
Na instrução do agente, escreva o que ele deve saber sobre o seu negócio. Exemplo:

Você é o assistente virtual da [Nome da Empresa].
Responda as dúvidas dos clientes de forma simpática e direta.
Horário de funcionamento: segunda a sexta, das 9h às 18h.
Serviços: [liste aqui].
Para contratar, peça o nome e o e-mail e diga que um especialista vai entrar em contato em até 24 horas.
Nunca invente informações que não estão nesta instrução.

Em seguida, adicione uma ação "Enviar mensagem no WhatsApp (Z-API)". Configure para responder para o mesmo número que enviou a mensagem.
Salve o agente.

Quanto mais detalhe, melhor a resposta. Liste seus produtos, preços, políticas de troca, perguntas frequentes. Quanto mais o agente souber, melhor ele vai atender.

Teste e ative em produção

Antes de divulgar o número para os seus clientes, teste você mesmo:

Use um celular diferente e mande uma mensagem para o número conectado.
Em alguns segundos, o agente deve responder.
Teste cenários comuns: pergunta sobre preço, horário, como contratar, uma dúvida que você não configurou (para ver se ele admite que não sabe).
Ajuste a instrução do agente quantas vezes precisar até as respostas ficarem boas.

✅ Quando está pronto para produção?

Quando você testar 10 perguntas diferentes e as respostas estiverem todas corretas e no tom certo. Só aí divulga o número. Um agente mal configurado que responde errado é pior do que não ter agente nenhum.

Monitoramento: nos primeiros dias, acompanhe as conversas no histórico do Tasklet. Veja onde o agente erra e ajuste a instrução. Com o tempo, ele fica cada vez melhor no seu negócio.

Prefere ter o agente configurado por um especialista?

Se você não quer perder tempo configurando, temos consultoria especializada para implantar o agente no seu negócio em até 3 dias. Você foca no que importa, a gente cuida da parte técnica.

Quero o agente pronto Ver agentes por assinatura

Próximos tutoriais

Continue aprendendo com os próximos passos da série:

📋

Ver todos os tutoriais

How to create an agent that replies to customers on WhatsApp

You will learn how to connect Tasklet to WhatsApp and create an agent that automatically answers questions, sends information, and qualifies leads. Without you being online and without writing a single line of code.

⏱️ Estimated time: 30 minutes 📶 Level: Beginner 💸 Cost: Free to start

⚠️ Before you start: be honest with yourself

WhatsApp is the most used messaging app in Brazil, but automating it has its particularities. Meta (WhatsApp's parent company) does not want bots replacing people in an abusive way. There are two legal paths to connect an agent, each with different rules. This tutorial explains both clearly so you can choose the right one for your case.

What you will learn

1.Create your Tasklet account
2.Understand how WhatsApp connects
3.Set up the Z-API connection
4.Create the incoming message trigger
5.Build the reply agent
6.Test with your own number
7.Go live

What you will need

🤖

Tasklet.ai account

Free to start. This is where you will build and run your agent.

→ Create free account at tasklet.ai

📱

A dedicated WhatsApp number

We recommend using a separate SIM from your personal one. This prevents the bot from mixing with your personal conversations.

🔌

Z-API account (simplest path)

A service that bridges WhatsApp to Tasklet. Has a free plan for testing.

→ Create account at z-api.io

Step by step

Create your Tasklet account

Go to tasklet.ai and create a free account. Tasklet is the platform where you will build, configure, and run your agent. Think of it as the "brain" that reads incoming messages and decides what to reply.

Tip: use your business email, not your personal one. It makes it easier to separate projects.

Create and connect your Z-API instance

Z-API works as a bridge between WhatsApp and Tasklet. Here is how to set it up:

Go to z-api.io and create a free account.
In the Z-API dashboard, click "New Instance" and give it a name.
A QR Code will appear. Open WhatsApp on the dedicated phone, go to Settings › Linked Devices › Link a device, and scan the QR Code.
When the status changes to "Connected", you are done.

Important: the phone with this number needs battery and internet connection. Without that, the agent cannot receive messages. Many people use an old phone left at home just for this.

Save your Z-API credentials

After connecting, you will need two pieces of data from the Z-API dashboard:

Instance ID: identifies your instance
Client-Token: the access password

Tip: save these in a safe place. You will need them to connect to Tasklet.

Create the Z-API connection inside Tasklet

Now we tell Tasklet how to talk to your WhatsApp:

In Tasklet, click "Connections" in the sidebar.
Click "New connection" and search for "Z-API".
Paste the Instance ID and Client-Token from the previous step.
Click "Test connection". If you see a green confirmation, it is working.

Create the incoming message trigger

The trigger is what wakes up the agent every time a new message arrives:

In Tasklet, go to "Triggers" and click "New trigger".
Choose "Message received on WhatsApp" (listed under Z-API).
Select the Z-API connection you just created.
Name the trigger, e.g. "New WhatsApp message".
Save and activate. A webhook URL will appear. Copy it.
Go back to Z-API, open "Instance Settings", and paste the webhook URL in the "On message received" field. Save.

Build the reply agent

Now the most important part: telling the agent what to do when it receives a message:

In Tasklet, click "New agent" and link it to the trigger you just created.
In the agent instruction, write what it needs to know about your business.
Add a "Send WhatsApp message (Z-API)" action configured to reply to the sender's number.
Save the agent.

The more detail, the better the replies. List your products, prices, return policies, FAQs. The more the agent knows, the better it will serve your customers.

Test and go live

Before sharing the number with customers, test it yourself:

Use a different phone to send a message to the connected number.
Within seconds, the agent should reply.
Test common scenarios and edge cases.
Adjust the agent instructions as many times as needed.

✅ When is it ready for production?

When you test 10 different questions and all answers are correct and in the right tone. Only then share the number. A misconfigured agent that gives wrong answers is worse than having no agent at all.

Prefer to have the agent configured by a specialist?

If you do not want to spend time configuring, we offer specialized consulting to set up the agent in your business within 3 days.

I want the agent ready See subscription agents

📋

See all tutorials

Cómo crear un agente que responde clientes en WhatsApp

Aprenderás a conectar Tasklet a WhatsApp y crear un agente que responde preguntas, envía información y califica prospectos automáticamente. Sin estar en línea y sin escribir una sola línea de código.

⏱️ Tiempo estimado: 30 minutos 📶 Nivel: Principiante 💸 Costo: Gratuito para empezar

⚠️ Antes de empezar: sé honesto contigo mismo

WhatsApp es la herramienta de comunicación más usada en Brasil, pero automatizarla tiene sus particularidades. Meta no quiere que los bots reemplacen a las personas de forma abusiva. Hay dos caminos legales para conectar un agente, y cada uno tiene reglas distintas. Este tutorial explica ambos con claridad para que elijas el más adecuado para tu caso.

Lo que aprenderás

1.Crea tu cuenta en Tasklet
2.Crea y conecta tu instancia Z-API
3.Guarda tus credenciales Z-API
4.Crea la conexión Z-API en Tasklet
5.Crea el trigger de mensajes entrantes
6.Construye el agente respondedor
7.Prueba y activa en producción

Lo que necesitarás

🤖

Cuenta en Tasklet.ai

Gratuita para empezar. Aquí crearás y ejecutarás tu agente.

→ Crear cuenta gratis en tasklet.ai

📱

Un número de WhatsApp dedicado

Recomendamos usar un chip separado de tu número personal. Evita que el bot mezcle con tus conversaciones personales.

🔌

Cuenta en Z-API (el camino más simple)

Servicio que conecta WhatsApp con Tasklet. Tiene plan gratuito para probar.

→ Crear cuenta en z-api.io

Paso a paso

Crea tu cuenta en Tasklet

Entra a tasklet.ai y crea una cuenta gratuita. Tasklet es la plataforma donde construirás, configurarás y ejecutarás tu agente. Piensa en él como el "cerebro" que leerá los mensajes entrantes y decidirá qué responder.

Consejo: usa el correo profesional de tu empresa, no el personal. Facilita la separación de proyectos.

Crea y conecta tu instancia Z-API

Z-API funciona como un puente entre WhatsApp y Tasklet. Así se configura:

Ve a z-api.io y crea tu cuenta gratuita.
En el panel de Z-API, haz clic en "Nueva Instancia" y dale un nombre.
Aparecerá un código QR. Abre WhatsApp en el celular dedicado, ve a Configuración › Dispositivos vinculados › Vincular dispositivo y escanea el código QR.
Cuando el estado cambie a "Conectado", ya está listo.

Importante: el celular con este número necesita batería y conexión a internet. Sin eso, el agente no recibirá los mensajes.

Guarda tus credenciales de Z-API

Después de conectar, necesitarás dos datos del panel de Z-API:

Instance ID: identifica tu instancia
Client-Token: la contraseña de acceso

Consejo: guárdalos en un lugar seguro. Los necesitarás para conectar con Tasklet.

Crea la conexión Z-API dentro de Tasklet

Ahora le decimos a Tasklet cómo hablar con tu WhatsApp:

En Tasklet, haz clic en "Conexiones" en el menú lateral.
Haz clic en "Nueva conexión" y busca "Z-API".
Pega el Instance ID y el Client-Token del paso anterior.
Haz clic en "Probar conexión". Si ves una confirmación verde, está funcionando.

Crea el trigger de mensajes entrantes

El trigger es lo que "despierta" al agente cada vez que llega un mensaje nuevo:

En Tasklet, ve a "Gatillos" y haz clic en "Nuevo gatillo".
Elige "Mensaje recibido en WhatsApp" (en la sección de Z-API).
Selecciona la conexión Z-API que acabas de crear.
Ponle un nombre como "Nuevo mensaje WhatsApp".
Guarda y activa el trigger. Aparecerá una URL de webhook. Cópiala.
Vuelve al panel de Z-API, abre "Configuración de la instancia" y pega la URL en el campo "Al recibir mensaje". Guarda.

Construye el agente respondedor

Ahora le decimos al agente qué hacer cuando recibe un mensaje:

En Tasklet, haz clic en "Nuevo agente" y vincúlalo al trigger recién creado.
En la instrucción del agente, escribe lo que debe saber sobre tu negocio: productos, precios, horarios, políticas.
Agrega una acción "Enviar mensaje en WhatsApp (Z-API)" configurada para responder al número que envió el mensaje.
Guarda el agente.

Cuanto más detalle, mejor la respuesta. Lista tus productos, precios, políticas de devolución, preguntas frecuentes.

Prueba y activa en producción

Antes de compartir el número con tus clientes, pruébalo tú mismo:

Usa un celular diferente y manda un mensaje al número conectado.
En segundos, el agente debe responder.
Prueba escenarios comunes y ajusta la instrucción cuantas veces sea necesario.

✅ ¿Cuándo está listo para producción?

Cuando pruebes 10 preguntas distintas y todas las respuestas sean correctas y en el tono adecuado. Solo entonces comparte el número. Un agente mal configurado es peor que no tener ninguno.

¿Prefieres que un especialista configure el agente?

Si no quieres perder tiempo configurando, tenemos consultoría especializada para implementar el agente en tu negocio en 3 días.

Quiero el agente listo Ver agentes por suscripción

📋

Ver todos los tutoriales