Como conectar o WhatsApp do SDR de Vendas IA (Z-API)

O SDR conversa com os alunos por um número de WhatsApp só dele, conectado a uma instância da Z-API. Neste artigo você cadastra a instância no CRM e configura o painel da Z-API para que as respostas dos alunos cheguem ao SDR.

Antes de começar

• O módulo SDR de Vendas IA contratado e o Assistente IA configurado.
• Um número dedicado ao SDR, diferente do número das notificações dos vendedores. De preferência um número já "aquecido" (com uso normal antes de ligar o SDR).
• Uma instância na Z-API (https://z-api.io) conectada a esse número (QR code lido) e, à mão:
  • o ID da instância e o Token da instância;
  • o Client-Token da conta (em Segurança).

Quem pode fazer

Só o Administrador do CRM.

Passo a passo

1. Cadastrar a instância no CRM

1. Acesse Configurações → Integrações e abra a aba SDR IA.
2. Em WhatsApp do SDR (Z-API), preencha:
   • Instance ID;
   • URL base (opcional): deixe em branco ou use https://api.z-api.io;
   • Token da instância;
   • Client-Token.
3. Clique em Salvar WhatsApp do SDR. A mensagem "WhatsApp do SDR salvo com segurança" confirma.

Os tokens são guardados criptografados e não voltam para a tela. Depois de salvo, o campo mostra só os últimos caracteres ("salvo: ••••..."): preencha só se for trocar.

2. Copiar a URL do webhook

1. Logo abaixo, em Webhook para colar na Z-API, clique em Copiar.
2. Essa URL tem um código secreto da sua instituição. Não compartilhe.

3. Configurar o painel da Z-API

No painel da Z-API, abra a instância e vá em Webhooks e configurações gerais.

Preencher com a URL copiada:

• Ao receber: obrigatório. Sem ele, o SDR não recebe as respostas dos alunos;
• Receber status da mensagem: mostra entregue e lida no painel de conversas.

Deixar em branco: Ao enviar, Ao desconectar, Ao conectar e Presença do chat (o SDR não usa).

Ligar:

• Notificar as enviadas por mim também: se alguém digitar direto no celular do SDR, a IA para naquela conversa;
• Ignorar mensagens de grupos (recomendado).

Manter desligado:

• Ignorar webhook de recebimento e Ignorar webhook de status;
• Ignorar mensagens de chats privados e de texto (o SDR deixaria de receber os alunos);
• Desabilitar enfileiramento quando o aplicativo estiver desconectado.

Clique em Salvar no fim da página da Z-API e confira se a instância está conectada ao número. Desconectada, o SDR não envia nem recebe.

Como conferir se funcionou

O SDR só conversa com números que ele mesmo abordou. Uma mensagem de um número qualquer para o SDR é ignorada e não aparece no painel. Para testar:

1. Com o SDR configurado e ligado (veja conversa, vendedores e horário), cadastre um lead de teste com o seu celular, dentro do horário de abordagem.
2. Espere a abertura chegar (depois do tempo de Abordar após).
3. Responda pelo seu celular.
4. Em SDR IA → Conversas, a conversa deve mostrar a sua resposta e a próxima pergunta da IA.
5. Avise o time comercial sobre o lead de teste.

Não precisa se preocupar com celulares sem o 9: o WhatsApp às vezes manda o número sem o nono dígito, e o SDR acerta isso sozinho.

Problemas comuns

Situação	Causa	Solução
A abertura sai, mas a resposta do aluno não aparece	Webhook Ao receber vazio ou errado	Cole a URL copiada em Ao receber e salve na Z-API
Nada sai nem chega	Instância desconectada	Leia o QR code de novo no painel da Z-API
Respostas não chegam mesmo com o webhook	"Ignorar webhook de recebimento" ou "Ignorar mensagens de chats privados" ligados	Desligue essas opções
Mensagem de teste de outro celular não aparece	O SDR só conversa com quem ele abordou	Teste com um lead cadastrado com o seu número
"Informe o Token e o Client-Token"	Primeiro cadastro sem os tokens	Preencha os dois e salve
Entregue/lida não aparece	Webhook Receber status da mensagem vazio	Cole a URL também nele

Dúvidas comuns

Posso usar o mesmo número das notificações dos vendedores? Não. Use um número dedicado, com instância própria. Misturar os dois confunde as conversas e aumenta o risco de bloqueio.

Se alguém da equipe responder pelo celular do SDR, o que acontece? Com Notificar as enviadas por mim também ligado, o sistema entende que uma pessoa assumiu e a IA pausa naquela conversa.

Como evitar que o número seja bloqueado pelo WhatsApp? Use um número aquecido, aborde em horário comercial, com alguns minutos de atraso depois do cadastro, e não aborde listas importadas. O SDR também limita quantas aberturas saem por minuto.

O que fazer se eu trocar de número? Conecte o novo número na instância (ou crie outra instância), salve o Instance ID e os tokens no CRM e confira os webhooks na Z-API.