Entender o que será configurado

O Dialogflow interpreta mensagens recebidas e identifica a intenção do contato. A resposta e o próximo passo dependem das intenções, frases de treinamento, parâmetros, contextos e respostas configurados no agente externo.

Preparar o agente Dialogflow ES

  1. 1

    Acesse o Google Cloud com uma conta corporativa autorizada.

  2. 2

    Crie ou selecione um projeto exclusivo para a integração.

  3. 3

    Ative a API do Dialogflow nesse projeto.

  4. 4

    Abra o Dialogflow ES e crie o agente associado ao mesmo projeto.

  5. 5

    Defina nome, idioma padrão e fuso horário de acordo com a operação.

  6. 6

    Crie as intenções necessárias e adicione frases de treinamento sem dados pessoais.

  7. 7

    Configure uma resposta de fallback para mensagens que o agente não compreender.

  8. 8

    Valide as principais intenções no simulador antes de continuar.

  • Use nomes claros para as intenções, como consultar_pedido, falar_com_atendente e encerrar_conversa.
  • Inclua diferentes formas de escrever a mesma solicitação, com abreviações e erros comuns.
  • Defina como ocorrerá a transferência para uma pessoa; não deixe essa regra apenas em uma resposta textual.
  • Revise idioma e fuso horário quando datas, horários ou saudações fizerem parte da conversa.

Criar uma identidade técnica com menor privilégio

A aplicação deve usar uma identidade técnica própria, separada das contas pessoais. Para chamadas de detecção de intenção no Dialogflow ES, o papel Cliente da API Dialogflow costuma oferecer o acesso de execução necessário. Conceda permissões adicionais somente quando uma necessidade técnica tiver sido confirmada.

  1. 1

    No projeto correto do Google Cloud, crie uma conta de serviço exclusiva para esta integração.

  2. 2

    Identifique a conta com um nome que informe ambiente e finalidade.

  3. 3

    Conceda somente o papel Cliente da API Dialogflow, identificado como roles/dialogflow.client, para o uso normal de detecção de intenção.

  4. 4

    Não conceda Proprietário, Editor ou Administrador do projeto apenas para fazer a integração funcionar.

  5. 5

    Registre responsável, finalidade, projeto, ambiente e data prevista para revisão.

Habilitar o Dialogflow no Atendeu Rápido

Configuração do Dialogflow com controles de habilitação e aplicação a todos os tickets
Ative primeiro a disponibilidade do Dialogflow. Mantenha a aplicação a todos os tickets desativada até concluir o teste controlado.
Imagem ampliada
  1. 1

    Acesse Configuração > Configurações.

  2. 2

    Abra a aba Bots IA e selecione Dialogflow no menu lateral.

  3. 3

    Ative Habilitar Dialogflow.

  4. 4

    Mantenha Habilitar para todos os tickets desativado durante a implantação.

  5. 5

    Selecione Salvar e confirme que a tela permaneceu habilitada.

Restringir a integração ao cenário de teste

  1. 1

    Escolha um canal de homologação ou um contato fictício controlado pela equipe.

  2. 2

    Use somente a forma de associação que estiver disponível e documentada no seu ambiente.

  3. 3

    Mantenha outros bots e automações externas desativados no mesmo cenário sempre que possível.

  4. 4

    Defina como o contato pedirá atendimento humano.

  5. 5

    Defina o que deve acontecer quando nenhuma intenção atingir confiança suficiente.

  6. 6

    Registre canal, contato, horário e resultado esperado antes do primeiro envio.

Executar um teste controlado

  1. 1

    Envie uma saudação prevista e confirme a intenção acionada.

  2. 2

    Repita a solicitação usando sinônimos, abreviações e um erro de digitação comum.

  3. 3

    Envie uma frase fora do escopo e confirme a resposta de fallback.

  4. 4

    Teste a solicitação de atendimento humano.

  5. 5

    Envie mensagens curtas em sequência e observe se há respostas duplicadas ou fora de ordem.

  6. 6

    Confirme no histórico se pergunta e resposta permanecem compreensíveis para o atendente.

  7. 7

    Repita o teste depois de encerrar e iniciar nova conversa para identificar contexto indevido.

  8. 8

    Registre cada entrada, intenção esperada, resposta recebida e resultado.

Proteger dados durante a operação

  • Envie ao agente somente os dados necessários para interpretar a solicitação.
  • Evite usar dados reais de clientes nas frases de treinamento e nos testes.
  • Não inclua senhas, documentos, dados financeiros ou informações sensíveis em parâmetros sem necessidade aprovada.
  • Defina retenção, acesso, auditoria e responsabilidade pela integração.
  • Revise os termos e a localização de processamento aplicáveis ao projeto externo.
  • Oriente os atendentes sobre quando assumir a conversa e como registrar falhas.

Corrigir problemas comuns

  • Dialogflow não aparece: confirme a permissão do usuário e se a opção existe em Bots IA no ambiente atual.
  • A configuração volta desativada: habilite novamente, selecione Salvar e confirme se houve erro ou bloqueio de permissão.
  • Nenhum ticket recebe resposta: confirme ativação global, associação do teste e se o agente pertence ao projeto correto.
  • Erro 401: confirme se a chave está ativa, íntegra e pertence à conta de serviço esperada; não edite manualmente o JSON.
  • Erro 403: confirme a API habilitada e o papel Cliente da API Dialogflow; não resolva concedendo acesso total sem análise.
  • Agente não encontrado: confira o projeto e se o agente é Dialogflow ES; não use identificadores do CX.
  • Mensagem não corresponde à intenção: revise idioma, frases de treinamento, parâmetros, contextos e fallback.
  • Respostas duplicadas: verifique se outro bot, Chat Flow ou integração está respondendo ao mesmo atendimento.
  • Funciona no simulador, mas não no atendimento: compare projeto, conta de serviço, associação e entrada recebida pelo canal.
  • A tela não oferece campo de credencial: não cole a chave em outro local; solicite validação da implantação técnica.

Liberar gradualmente para a operação

  1. 1

    Corrija todos os caminhos sem resposta, duplicados ou sem transferência.

  2. 2

    Aprove as mensagens com a equipe responsável pelo atendimento.

  3. 3

    Libere primeiro para um canal, fila ou grupo controlado, quando o ambiente permitir esse recorte.

  4. 4

    Monitore tickets reais em amostra e compare intenção esperada com resultado.

  5. 5

    Amplie o alcance por etapas.

  6. 6

    Ative Habilitar para todos os tickets somente quando esse for o desenho aprovado.

  7. 7

    Defina responsável por monitoramento, treinamento de intenções e rotação da credencial.

  • Fallback compreensível e sem loop.
  • Transferência humana validada.
  • Ausência de respostas duplicadas.
  • Idioma e tom revisados.
  • Credencial guardada e inventariada.
  • Permissões reduzidas ao necessário.
  • Plano de reversão e responsável definidos.