Chat Pró Oratrix: Como configurar o Dialogflow

Chat Pró Oratrix: Como configurar o Dialogflow

:parrot: SERVIÇO

Serviço: Chat Pró Oratrix

:hammer_and_wrench: VOCÊ VAI PRECISAR

  • Uma conta Google com acesso ao Google Cloud e ao Dialogflow.
  • Permissão para criar um projeto e um agente no Dialogflow.
  • Permissão para criar credenciais de serviço no Google Cloud.
  • Acesso ao menu Bots e IA do Chat Pró Oratrix.

:receipt: VISÃO GERAL

O Dialogflow pode ser integrado ao Chat Pró Oratrix para participar dos fluxos de atendimento automatizado.

O procedimento consiste em criar o projeto no Google Cloud, configurar o agente no Dialogflow, habilitar os serviços necessários, gerar uma credencial JSON e informar os dados correspondentes no Chat Pró Oratrix.

:compass: PASSO A PASSO GUIADO

1. Crie o projeto no Google Cloud

  1. Acesse o Google Cloud Console.
  2. Faça login com sua conta Google.
  3. Abra o seletor de projetos.
  4. Clique em Novo Projeto.
  5. Informe um nome para o projeto.
  6. Clique em Criar.
  7. Aguarde a criação ser concluída.

2. Configure o agente no Dialogflow

  1. Acesse o Dialogflow com a mesma conta Google.
  2. Crie um novo agente.
  3. Vincule o agente ao projeto Google Cloud criado anteriormente.
  4. Configure o idioma e as demais opções necessárias para sua operação.
  5. Salve o agente.

3. Confirme o ID do projeto

  1. Volte ao Google Cloud Console.
  2. Abra o projeto utilizado no Dialogflow.
  3. Localize o ID do projeto.
  4. Anote esse identificador para utilizar na integração.

4. Crie a credencial JSON

  1. No Google Cloud Console, abra a área de IAM e administrador ou a área de contas de serviço, conforme apresentada na interface atual.
  2. Crie uma conta de serviço para a integração.
  3. Abra a conta de serviço criada.
  4. Acesse Chaves.
  5. Clique em Adicionar chave → Criar nova chave.
  6. Selecione JSON.
  7. Clique em Criar.
  8. Salve o arquivo em local seguro.

:locked_with_key: O arquivo JSON contém credenciais de autenticação. Não compartilhe esse conteúdo em chamados, grupos ou capturas de tela.

5. Configure o Dialogflow no Chat Pró Oratrix

  1. Acesse o Chat Pró Oratrix.
  2. Abra Configurações.
  3. Clique em Bots e IA.
  4. Localize a área de Dialogflow.
  5. Informe o Project ID do projeto criado no Google Cloud.
  6. Abra o arquivo JSON em um editor de texto confiável.
  7. Copie o conteúdo completo da credencial.
  8. Cole o conteúdo no campo de credenciais do Dialogflow.
  9. Salve a configuração.

6. Teste a integração

  1. Use um contato ou ticket de teste.
  2. Inicie o fluxo onde o Dialogflow será utilizado.
  3. Envie uma mensagem de teste.
  4. Confirme se o atendimento foi processado pelo agente configurado.
  5. Se não houver resposta, revise o Project ID, a credencial JSON e a configuração do agente.

:warning: OBSERVAÇÕES IMPORTANTES

  • :warning: O projeto Google Cloud e o agente Dialogflow precisam estar vinculados corretamente.
  • :warning: O conteúdo do JSON deve ser mantido em sigilo.
  • :warning: Não exponha chaves, tokens ou credenciais em documentação pública.
  • :warning: Este artigo não inclui código de sistema, customização de frontend, infraestrutura de servidor ou procedimentos de Super Admin.

:gear: DICAS E BOAS PRÁTICAS

  • Utilize um projeto dedicado à integração quando possível.
  • Faça testes com intenções simples antes de criar fluxos complexos.
  • Mantenha o agente organizado por intents e contextos claros.
  • Revogue e substitua a chave se houver suspeita de exposição.

:bar_chart: RESULTADO ESPERADO

Depois da configuração, o Chat Pró Oratrix poderá utilizar o agente Dialogflow nos cenários de automação compatíveis definidos em Bots e IA.

:receipt: RESUMO FINAL

Crie o projeto no Google Cloud, configure o agente Dialogflow, gere a credencial JSON, informe o Project ID e a credencial no Chat Pró Oratrix e faça um teste controlado.

:label: KEYWORDS

Dialogflow, Google Cloud, chatbot, integração, Chat Pró Oratrix