Como levar seu chatbot do Dialogflow para o Yuzap

Os chatbots ajudam equipes de engajamento a lidar com dúvidas repetitivas. Neste guia, você cria um bot no Dialogflow e o integra ao Yuzap em poucos passos.

1) Criar o bot no Dialogflow

Passo 1 — Acessar o Console

Entre no Console do Dialogflow (usaremos o Dialogflow Essentials). Clique em Criar Agente.

Passo 2 — Definir intenções

Crie intenções conforme as respostas desejadas do seu bot. O projeto já vem com:

• Default Fallback Intent

• Default Welcome Intent

Você pode (e deve) adicionar intenções específicas do seu caso de uso. O Yuzap também suporta intenções avançadas (ex.: transferência para agente, mensagens interativas). Veja a seção Intenções Avançadas abaixo.

Passo 3 — Criar Conta de Serviço (Google Cloud)

Para conectar o bot ao Yuzap, crie uma conta de serviço no Google Cloud:

• No Dialogflow, abra as Configurações do projeto e clique no ID do projeto para ir ao Google Cloud Console.

• Acesse IAM e Administração → Contas de serviço e clique em Criar conta de serviço.

• Informe nome e descrição.

• Conceda o papel Dialogflow API Client.

• Conclua a criação e, na aba Chaves, clique em Adicionar chave → JSON → Criar.

• Baixe o arquivo JSON e guarde com segurança (usaremos no Yuzap).

---

2) Configurar a integração Dialogflow ↔ Yuzap

O Yuzap possui integração nativa com o Dialogflow.

Passo 1 — Ativar integração

No Yuzap, acesse Configurações → Aplicativos → Dialogflow e clique em Configurar.

Passo 2 — Adicionar gancho (webhook)

Clique em Adicionar um novo gancho e preencha:

• ID do Projeto (Dialogflow)

• Arquivo de Chave do Projeto (conteúdo do JSON que você baixou)

• Caixa de entrada (inbox) em que o bot atuará

Cole o conteúdo do JSON no campo solicitado (não faça upload como anexo).

Pronto! A integração está concluída. Abra sua inbox Website e teste uma mensagem: o bot deverá responder.

---

Intenções Avançadas

A) Transferência para agente humano

Quando o usuário pedir para falar com alguém, o Dialogflow deve sinalizar ao Yuzap para um agente assumir.

1. Crie a intenção “Intenção de transferência” com frases de treinamento (ex.: “Falar com um agente”, “Quero atendimento humano”).

2. Resposta com Carga útil personalizada:

{
  "action": "handoff"
}

Ao acionar essa carga, o Yuzap muda o status da conversa para open e a encaminha a um agente.

---

B) Mensagens interativas (somente na inbox Website)

A integração Yuzap-Dialogflow suporta mensagens interativas no widget do site:

• Opções (com acompanhamento)

• Cartões

• Artigos

Exemplo — Opções (input_select):

{
  "content_type": "input_select",
  "content": "Select your favorite food from below",
  "content_attributes": {
    "items": [
      { "value": "I like sushi",  "title": "Sushi"   },
      { "value": "I like biryani","title": "Biryani" },
      { "value": "I like pizza",  "title": "Pizza"   }
    ]
  },
  "private": false
}

Quando o usuário seleciona uma opção, o valor retorna ao Dialogflow — permitindo criar intenções de acompanhamento (ex.: intenção com frase “I like biryani” para a opção Biryani).

Você pode criar outros tipos alterando a carga útil conforme o guia de mensagens interativas do Yuzap.

---

Fluxo de status: bot ↔ agente

• Com o bot do Dialogflow conectado a uma inbox, novas conversas nascem com status pending (o bot faz a triagem inicial).

• Quando há handoff, a conversa vai para open e o bot para de responder.

• Para devolver ao bot, o agente pode trocar o status de open para pending: o bot retoma as respostas.

---

Checklist rápido

• Bot criado no Dialogflow (intenções básicas + específicas)

• Conta de serviço criada e chave JSON baixada

• Integração Dialogflow → Yuzap configurada (ID do projeto + chave JSON + inbox)

• Teste realizado na inbox Website

• (Opcional) Intenções avançadas: handoff e mensagens interativas

• Fluxo de status validado (pending ↔ open)

Tudo certo! Seu bot do Dialogflow está pronto para atender no Yuzap, com handoff suave para agentes e suporte a mensagens interativas no widget do site.

Pensamento estendido