For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/automations/ai-sdr-step.md.
  • Português

      • Como deixar a IA conversar com o contato e seguir pelo resultado da conversa?

      Adicione o bloco SDR de IA na automação. Ele abre a conversa pela conexão do atendimento que você escolher — WhatsApp, Instagram, Telegram ou Webchat — e o agente conduz com o roteiro, as perguntas de qualificação e o jeito de falar que já tem no atendimento. Quando a conversa termina, a automação segue pela saída do resultado — por exemplo Qualificado, Agendou reunião, Desqualificado ou Pediu um humano.

      Antes de começar:

      • Um agente de IA com um atendimento ligado. Veja Como colocar o agente de IA para atender no WhatsApp, Instagram, Telegram ou Webchat?.
      • No WhatsApp oficial, um template aprovado no número do atendimento. Quem não mandou mensagem para esse número nas últimas 24 horas sempre recebe o template, porque fora dessa janela o WhatsApp não aceita mensagem livre.
      • No Instagram, Telegram e Webchat não existe template: a IA só consegue falar com quem já tem uma conversa com aquela conta, dentro da janela do canal (24 horas no Instagram, ou 7 dias com a Human Agent tag; sem janela no Telegram e no Webchat). Funciona bem com gatilhos de mensagem recebida, comentário ou nova conversa.

      Passos

      1. Na automação, clique em + e escolha SDR de IA. O bloco tem três grupos no card: Primeira mensagem, Quem conduz e Limites.
      2. Em Primeira mensagem, escolha o Atendimento de IA. Só aparecem atendimentos ligados. Se ainda não tiver um, clique em Criar atendimento na lista (ou no próprio bloco, no canvas). Abre em outra aba: sem nenhum agente publicado, a configuração guiada do SDR (veja Como configurar o SDR de IA do zero?); com um agente, a aba Atendimento dele; com vários, a lista de Meus agentes. Ao voltar, o atendimento novo já aparece na lista.
      3. Escolha a Conexão (só as conexões desse atendimento, de qualquer canal). O que vem a seguir depende do canal dela:
        • WhatsApp oficial: escolha o Template aprovado e, se ele tiver variáveis, preencha cada uma. (Opcional) Em Texto livre na janela de 24h, escreva a mensagem para quem mandou mensagem para esse número nas últimas 24 horas. Essas pessoas recebem o texto, sem custo de template, e as demais recebem o template. Deixe vazio para mandar o template para todo mundo.
        • Instagram, Telegram, Webchat ou WhatsApp Web: não há template. Aparece o aviso O agente abre a conversa: a própria IA escreve a primeira mensagem na conversa que o contato já tem com essa conta, seguindo o roteiro do agente. Se a mensagem que disparou a automação já foi respondida pelo atendimento há poucos minutos, a IA não manda uma segunda resposta: ela espera o contato e conduz a partir dali.
      4. Confira no card, em Quem conduz, o agente do atendimento e o canal da conexão. O bloco não tem objetivo, perguntas nem regras próprias: tudo isso vem do agente. Para mudar como ele conversa ou o que ele pergunta, edite o agente em Meus agentes.
      5. (Opcional) Em Limites, ajuste o Máximo de mensagens da IA, as Palavras de saída e o tempo em Esperar resposta por (horas).
      6. Ligue cada saída do bloco ao próximo passo e publique a automação.

      Por onde a automação segue

      O bloco tem uma saída que corre ao lado da conversa e dez saídas de desfecho, em dois grupos.

      Ao lado da conversa

      • Primeira mensagem enviada — a primeira mensagem saiu para o contato: o template ou o texto livre no WhatsApp oficial, ou a primeira fala da IA no Instagram, Telegram e Webchat. A automação segue por aqui na hora, enquanto a IA continua conversando no bloco. Quando a conversa terminar, a automação também segue pela saída do desfecho. Use para avisar a equipe, mover o card ou marcar o contato logo que a campanha começa. Se a mensagem não sai (contato sem conversa na conta, fora da janela do canal, ou com alguém da equipe atendendo), esta saída não acontece.

      A IA decide

      • Qualificado — o agente encerrou a conversa com o contato qualificado.
      • Agendou reunião — a IA marcou uma reunião com o contato na agenda do atendimento, num horário livre que o contato aceitou. A IA confirma o horário ao contato e só então a automação segue por aqui. A reunião é criada como qualquer agendamento do CRM: as confirmações de agendamento são enviadas e as automações com o gatilho Reunião Agendada disparam.
      • Desqualificado — o agente encerrou a conversa porque o contato não tem perfil.
      • Pediu um humano — o contato pediu para falar com uma pessoa.
      • IA sem confiança — a IA não soube responder com segurança.

      Automáticas — não dependem da IA

      • Limite atingido — a IA chegou ao Máximo de mensagens da IA, ou ia repetir a mesma pergunta pela terceira vez.
      • Erro da IA — a IA falhou em duas respostas seguidas (por exemplo, chave do provedor inválida; falhas passageiras, como o provedor ocupado, ela já tenta de novo sozinha antes de contar), uma mensagem da IA não chegou ao contato porque o canal recusou o envio (por exemplo, número de WhatsApp desconectado ou bloqueado), ou a conversa não pôde começar porque o atendimento foi desligado ou o contato já está numa conversa desse mesmo atendimento. Se você cancelar a execução da automação, a conversa do bloco termina junto e o contato fica livre para outra.
      • Sem resposta — o contato ficou em silêncio pelo tempo de Esperar resposta por (horas). Se o atendimento tem retomada configurada, as retomadas acontecem antes, e depois da última o contato ainda tem esse mesmo tempo para responder. A automação também segue por aqui na hora quando a conversa nem pôde começar: a primeira mensagem não chegou ao contato (por exemplo, ele pediu para não receber WhatsApp) ou, no Instagram, Telegram e Webchat, o contato nunca conversou com aquela conta ou está fora da janela do canal.
      • Pediu para sair — o contato escreveu uma das Palavras de saída numa mensagem curta. O contato passa a não receber mensagens no canal da conversa (WhatsApp, Instagram ou Telegram) mesmo que essa saída não esteja ligada a nada.
      • Humano assumiu — alguém da equipe assumiu ou recebeu a conversa no Chat ao Vivo. Se o contato já está em atendimento com alguém da equipe nessa conexão quando a automação chega no bloco, nada é enviado e a automação segue por aqui na hora. Para parar outras automações do contato (uma cadência de retomada, por exemplo) no mesmo momento, use o gatilho Atendente assumiu a conversa como condição de saída — veja como parar a cadência quando um atendente assume a conversa.

      O que mais você precisa saber

      • Pediu um humano, IA sem confiança, Limite atingido e Erro da IA já passam a conversa para a equipe antes de seguir (veja Para onde vai a conversa quando passa para a equipe). O contato não fica sem resposta mesmo que a saída não tenha próximo passo.
      • Quando a conversa termina, por qualquer saída, a IA para de responder naquela conversa. Se o contato responder depois disso, a conversa passa para a equipe, com a mensagem Contato respondeu depois que o SDR de IA encerrou e a saída por onde a conversa terminou. Isso acontece uma vez: as próximas mensagens do contato continuam na mesma conversa, que já está com a equipe.
      • No WhatsApp oficial, a IA sabe com que mensagem a conversa começou: o template ou o texto livre que o bloco enviou entra no contexto dela, então um "sim" do contato é entendido como resposta àquela mensagem.
      • Se alguém da equipe assumir a conversa enquanto a IA ainda está escrevendo, a resposta dela não é enviada.
      • Se o contato mandar várias mensagens seguidas enquanto a IA responde, ela responde de novo ao que ficou sem resposta.
      • Se o contato mandar um áudio e a transcrição automática do Chat ao Vivo estiver ligada, a IA espera a transcrição (até cerca de um minuto e meio) e responde ao que o contato falou. Sem transcrição, ela responde sabendo só que chegou um áudio. Em fotos, vídeos e documentos, a IA lê a legenda.
      • Se a conversa já terminou e a automação continuou parada no bloco, ela segue sozinha pela saída da conversa em até 20 minutos.
      • Uma saída de desfecho sem próximo passo encerra a automação para aquele contato. Primeira mensagem enviada sem próximo passo não faz nada.
      • Fora do horário do atendimento, a IA avisa o contato uma vez que o horário encerrou e volta a conversar na próxima mensagem dele dentro do horário. O tempo fora do horário não conta como silêncio.
      • Se a automação chega no bloco fora do horário do atendimento, a primeira mensagem não sai: o contato fica esperando no bloco e recebe a mensagem (ou a IA abre a conversa) quando o horário abrir.
      • Palavras de saída só valem em mensagens curtas. "Pare" encerra; "vou sair do trabalho às 18h, me chama depois" não.
      • Com Substituir o que a equipe preencheu desligado, a IA só preenche campos personalizados vazios ou que ela mesma preencheu, e campos do contato que estão vazios.
      • Em Data de nascimento, a IA só grava quando a resposta é uma data reconhecível; "semana que vem" fica de fora.
      • A conversa segue o bloco como estava quando começou. Editar o bloco depois não muda as conversas que já estão em andamento.
      • Blocos criados antes desta mudança podem ter objetivo, jeito de falar, campos e regras gravados. Eles não valem mais: as conversas que começam agora seguem só o agente.

      Para onde vai a conversa quando passa para a equipe

      Quando a IA passa a conversa para a equipe — por uma das saídas acima ou porque o contato respondeu depois do fim:

      • A conversa entra na fila do Chat ao Vivo.
      • Uma mensagem na conversa, visível só para a equipe, explica o motivo. Ex.: SDR de IA passou a conversa para a equipe (saída: Pediu um humano), seguida do motivo que a IA registrou.
      • Se o atendimento tem um time em Quem recebe a conversa (escolhido na aba Atendimento do agente, em Editar), a conversa é atribuída a alguém desse time, pelo rodízio do próprio time. Só entra no rodízio quem atende a conexão da conversa. Se ninguém do time estiver disponível, ou se o atendimento não tiver time, a conversa fica em aberto, sem atendente, para qualquer pessoa da equipe assumir.
      • Se alguém da equipe já está atendendo a conversa, ela continua com essa pessoa.

      Como ver o que a IA fez numa conversa

      Abra a execução do contato no painel Execução passo a passo e selecione o passo SDR de IA. Ele mostra se a conversa está Em andamento ou Encerrada, por qual saída terminou e por quê, quantas falas a IA usou do limite, cada ferramenta que a IA usou. Ver a seção No passo SDR de IA.