Resposta rápida: Para configurar o Agente de IA na Sutofly Broadcast, acesse Auto Atendimento → Agentes de IA, crie o agente e preencha as cinco etapas: negócio, qualificação, encaminhamento, disponibilidade e limites. Depois, salve, vincule a uma regra ou interação e use Diagnóstico e teste antes de atender clientes.
Este guia descreve o módulo Agentes de IA da Sutofly Broadcast. Os nomes dos campos e os limites apresentados correspondem à configuração descrita para o produto nesta publicação.
Antes de começar
Para usar o agente, tenha um número de WhatsApp conectado, acesso à tela de Auto Atendimento e uma chave de API da OpenAI que possa ser usada pela sua conta. As chamadas ao modelo e a geração de imagens, quando ativada, são cobradas pela OpenAI na conta vinculada à chave cadastrada. Consulte a tabela oficial de preços da API da OpenAI para avaliar os custos de uso.
O módulo está disponível para contas dos planos Essencial e Pro Escalando, além de contas com liberação específica. A disponibilidade do módulo não significa que um agente já esteja atendendo: ele ainda precisa ser criado e vinculado a um gatilho.
Acesse Auto Atendimento → Agentes de IA e clique em Criar agente. A configuração aparece em cinco etapas.
Etapa 1: apresente seu negócio ao agente
Comece pelo Nome do agente. Esse nome ajuda sua equipe a identificar a configuração. Você também pode informar o Nome do negócio, que dá contexto às respostas.
Um recado rápido 👋
Atender bem no WhatsApp não precisa ser complicado.
Na Sutofly a gente vive isso todo dia: ferramentas de atendimento e vendas no WhatsApp. E com a ONAI, nossa plataforma com API oficial da Meta, seu número fica protegido e seu cliente continua falando com gente de verdade.
Se quiser um ponto de partida, escolha um dos exemplos de Recepção, Clínica ou Orçamentos. O exemplo preenche orientações iniciais e alguns dados de qualificação; revise tudo para que corresponda à sua operação real.
Em Como deseja orientar o agente?, há duas formas de trabalhar:
Preencher informações do negócio é o caminho mais direto. Descreva o que a empresa faz, escolha o tom da conversa e acrescente produtos, serviços, links e informações de referência. A descrição do negócio e o tom são necessários nesse modo.
Escrever instruções livres (avançado) permite redigir as orientações em um único campo. Use-o quando já souber exatamente como deseja conduzir a conversa. As ações, os dados a coletar e os limites continuam sendo configurados nas outras etapas.
Um exemplo de orientação para uma empresa de serviços seria:
Você é o primeiro contato da empresa. Cumprimente a pessoa, entenda qual serviço ela procura e faça uma pergunta por vez. Responda apenas com informações cadastradas. Se não souber um preço ou prazo, diga que a equipe vai confirmar.
Depois, escolha o Modelo de IA entre as opções exibidas na tela: GPT-4o mini, GPT-4o ou GPT-4.1. Os modelos podem produzir respostas diferentes e ter custos diferentes. Use o teste de conversa para avaliar a opção escolhida no seu caso.
Por fim, cadastre a Chave de API da OpenAI. Ela é necessária para conversar e testar. Após salvar, a chave não é exibida novamente; ao editar um agente, deixe o campo vazio se quiser manter a chave existente.
Etapa 2: configure a qualificação
Em Quais dados precisa coletar?, clique em Adicionar dado para criar os campos da conversa. Para cada um, informe:
- Nome do dado: o rótulo que você reconhece, como “E-mail” ou “Serviço de interesse”.
- Identificador: um nome simples para o campo, como email ou servico.
- Formato: texto, e-mail ou telefone.
- Obrigatório: marque quando o agente deve buscar essa informação antes de encaminhar por qualificação.
Você pode cadastrar até 15 dados. Use identificadores diferentes, com letras minúsculas, números e sublinhado.
Uma configuração inicial para pedidos de orçamento poderia ser:
| Nome do dado | Identificador | Formato | Obrigatório? |
|---|---|---|---|
| Nome | nome | Texto | Sim |
| Serviço desejado | servico | Texto | Sim |
| Não | |||
| Prazo desejado | prazo_desejado | Texto | Não |
Marcar um dado como obrigatório orienta o fluxo de qualificação. Isso não impede que alguém peça atendimento humano antes de fornecê-lo.
Em Critérios de classificação interna, descreva quando um contato deve ser considerado quente, morno ou frio. Por exemplo: “Quente: quer contratar em breve e informou o serviço. Morno: demonstra interesse, mas ainda está avaliando. Frio: procura apenas informações gerais.” A classificação é interna e depende da interpretação da IA.
Se desejar que o atendimento siga para a equipe assim que todos os dados obrigatórios forem reunidos, marque Encaminhar assim que todos os dados obrigatórios forem coletados. Para ativar essa opção, configure ao menos um dado obrigatório e um destino de encaminhamento na próxima etapa.
Por último, selecione Etiquetas que o agente pode usar. Escolha somente as que fazem sentido para esse atendimento. A lista limita quais etiquetas o agente pode adicionar ou remover.
Etapa 3: decida quem continua o atendimento
Em Atendente no sistema, escolha uma pessoa ativa da equipe se quiser que a conversa seja atribuída diretamente a ela. Esse usuário receberá a atribuição e uma notificação interna com o resumo do atendimento.
Se você deixar Sem atribuição automática, o agente poderá encerrar sua participação e sinalizar a solicitação como pendente para a equipe acompanhar. Isso é diferente de entregar a conversa a um atendente específico.
O campo Avisar também por WhatsApp permite informar um número adicional para receber o resumo. Digite DDD e telefone; o DDI brasileiro 55 é acrescentado quando necessário. A entrega depende das condições de envio de mensagens para esse destinatário. Use esse aviso como apoio, não como prova de que alguém assumiu a conversa.
Em Palavras para pedir uma pessoa, cadastre expressões claras, separadas por vírgulas, como falar com atendente e atendente humano. Quando o contato usa uma dessas expressões, o sistema inicia o encaminhamento sem depender de uma decisão da IA. Evite termos muito genéricos, que possam aparecer em perguntas comuns.
Quando uma atribuição realmente acontece, o sistema envia ao contato a confirmação correspondente. Se não conseguir atribuir, encerra a participação do bot e indica que o atendimento ficou pendente para a equipe.
Etapa 4: escolha quando o agente atende
Em Disponibilidade do agente, escolha uma das três opções:
- Todos os dias, a qualquer hora: não impõe um horário próprio ao agente.
- Escolher dias e horários: define início, fim e dias da semana. Se nenhum dia específico for selecionado, a configuração considera todos os dias.
- Somente fora do horário comercial da empresa: usa o expediente definido em Configurações → Negócio e disponibiliza o agente fora dele.
Os horários são apresentados no horário de Brasília. Confira os dias selecionados com cuidado: um agente limitado a sábado e domingo, por exemplo, não assumirá um contato na segunda-feira.
Nessa etapa também existe Habilitar agente. Um agente desativado não inicia novos atendimentos; ao desativá-lo e salvar, as sessões em andamento são interrompidas para que a equipe possa continuar.
A disponibilidade define quando ele pode responder, mas não substitui o gatilho que inicia a conversa.
Etapa 5: configure integrações e limites
Se quiser enviar os dados coletados para outro sistema, preencha Enviar dados para outro sistema com uma URL HTTPS pública. O destino precisa estar preparado para receber os dados e evitar processamento duplicado quando houver uma nova tentativa de entrega.
Em Limite de chamadas de IA por atendimento, defina o máximo para uma sessão. Ao atingir esse limite, o atendimento é encaminhado para acompanhamento humano. A tela aceita valores de 3 a 100.
Para permitir imagens, marque Permitir gerar e enviar imagens e escolha o Máximo de imagens por atendimento, entre 0 e 5. Mantenha a opção desativada se o seu fluxo não precisa dela: cada geração pode aumentar o custo na OpenAI.
Clique em Salvar agente.
Faça a ligação que ativa o agente
Salvar o agente é apenas a primeira parte. Para o caminho mais comum:
- Volte à aba Regras em Auto Atendimento.
- Crie ou edite uma regra para o número de WhatsApp desejado.
- Escolha o acionamento da regra, por exemplo uma palavra-chave ou uma mensagem recebida, conforme o fluxo que você quer criar.
- Nas ações da regra, escolha Acionar agente de IA e selecione o agente salvo.
- Salve e habilite a regra.
Também é possível vincular o agente como destino de um botão ou item de lista interativa. Ao configurar o destino daquela escolha, selecione Agente de IA e depois o agente correspondente. Fluxos de remarketing configurados para iniciar um agente são outra possibilidade.
Em todos os casos, a regra ou interação precisa ser acionada. O agente não aborda contatos por iniciativa própria.
Teste antes de usar com clientes
Na lista de agentes, clique em Diagnóstico e teste. Primeiro, confira os gatilhos encontrados, o estado do WhatsApp, o horário do agente e o destino no painel. Depois, use Simular uma conversa para enviar mensagens de exemplo.
Experimente pelo menos estes cenários: uma dúvida simples, um contato que fornece todos os dados, um contato que não fornece um dado obrigatório e alguém que pede um atendente humano imediatamente. O teste mostra a resposta e a ação proposta.
A simulação usa a chave da OpenAI e pode gerar cobrança, mas não envia WhatsApp, não salva dados de um contato real e não executa transferências ou integrações. Por isso, depois de ajustar o comportamento no teste, acompanhe também o primeiro atendimento real de perto.
Perguntas frequentes
O que preciso para configurar o Agente de IA da Sutofly?
Você precisa de um WhatsApp conectado, acesso ao módulo Auto Atendimento e uma chave de API da OpenAI utilizável na sua conta. O módulo está disponível nos planos Essencial e Pro Escalando, além de contas com liberação específica.
Salvar o agente já ativa o atendimento no WhatsApp?
Não. Além de habilitar e salvar, é necessário vincular o agente a uma regra ou interação e acionar esse gatilho dentro das condições de disponibilidade.
Preciso coletar todos os dados antes de chamar um atendente?
Não. Os campos obrigatórios orientam o encaminhamento por qualificação, mas o contato pode pedir uma pessoa antes de preenchê-los. Configure expressões claras para solicitar atendimento humano.
O teste do agente envia mensagens para clientes?
Não. A simulação pode consumir a API da OpenAI, mas não envia WhatsApp, não salva dados em um contato real e não executa transferências ou webhooks. Acompanhe também um atendimento real após validar a configuração.
Continue aprendendo sobre o Agente de IA
- Agente de IA no WhatsApp: o que faz na Sutofly Broadcast
- Agente de IA não responde? Diagnóstico na Sutofly Broadcast
Leitura complementar: Exemplos de perguntas e scripts para atendimento comercial.
Quer conhecer a solução? Veja a Sutofly para atendimento e automação no WhatsApp. Se já utiliza a Sutofly Broadcast, acesse Auto Atendimento → Agentes de IA para conferir a disponibilidade na sua conta.