O componente pré-criado de saudação recupera o número de telefone do autor da chamada (ANI), se disponível. Se o número de telefone for recuperado, o componente fará uma autenticação flexível usando o número de telefone, validando-o em relação aos números registrados. Em seguida, o agente cumprimenta o usuário final com uma mensagem personalizada com base nas informações da conta.
Limitações
Além das limitações comuns de componentes pré-criados, esse componente pré-criado tem as seguintes limitações:
- O componente pressupõe que os números de telefone dos clientes sejam mantidos em um sistema de gestão de relacionamento com o cliente (CRM) ou outro serviço.
- Clientes atuais que usam um número de telefone alternativo para entrar em contato não serão autenticados por esse componente.
Exemplos de diálogos
As caixas de diálogo de exemplo abaixo demonstram cenários comuns processados por esse componente pré-criado. As caixas de diálogo de exemplo demonstram o comportamento quando o componente é chamado por telefonia, o que aciona a intent de boas-vindas padrão e a primeira resposta do agente no início da conversa.
Usuário final autenticado
O usuário final é identificado com base no número que faz a chamada e recebe uma mensagem de saudação personalizada.
| Entrada do usuário | Resposta do agente |
|---|---|
| Olá, [Nome do autor da chamada], Agradecemos por entrar em contato com a [Nome da empresa]. Estamos comprometidos com sua saúde financeira. Como podemos ajudar você hoje? |
Usuário final não identificado
O número de chamada do usuário final não é identificado, e ele recebe a mensagem de saudação padrão.
| Entrada do usuário | Resposta do agente |
|---|---|
| Agradecemos por entrar em contato com a [Nome da empresa]. Estamos comprometidos com sua saúde financeira. Como podemos ajudar você hoje? |
Convenções de nomeação
Esse componente pré-criado usa as seguintes convenções de nomenclatura:
| Recurso | Formato | Exemplo |
|---|---|---|
| Fluxo | [Nome do componente] | Saudação |
| Parâmetro | [nome_do_parâmetro] | ani_auth |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_greeting:get_account_details |
Parâmetros de entrada
Os parâmetros de entrada são usados para configurar determinados comportamentos do componente. Os parâmetros são usados por uma ou mais condições no fluxo para determinar como o componente vai se comportar. Os parâmetros com escopo de fluxo precisam ser definidos na página inicial do componente, conforme descrito abaixo. Os parâmetros no escopo da sessão podem ser definidos por um fluxo de chamada ou na página inicial desse componente.
Esse componente pré-criado aceita os seguintes parâmetros de entrada:
| Nome do parâmetro | Descrição | Formato da entrada |
|---|---|---|
| $flow.nome_da_empresa | Captura o nome da empresa que será usado dinamicamente no prompt da Saudação. | string |
Para configurar os parâmetros de entrada desse componente, abra para conferir as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Build.
- Clique no componente importado na seção Fluxos.
- Clique na página inicial na seção Páginas.
- Clique na rota true na página inicial.
- Na janela "Rota", edite os valores de Predefinições de parâmetros conforme necessário.
- Clique em Save.
Parâmetros de saída
Os parâmetros de saída são parâmetros de sessão que permanecerão ativos após a saída do componente. Esses parâmetros contêm informações importantes coletadas pelo componente. Esse componente pré-criado fornece valores para os seguintes parâmetros de saída:
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| ani_auth | Esse parâmetro captura o resultado da autenticação baseada em ANI. Por padrão, o valor é falso. | boolean |
| auth_level | Indica o nível de autenticação do autor da chamada. Por padrão, o valor é nulo. -1 indica que o usuário não foi autenticado pela ANI. O valor 0 indica que a autenticação da ANI foi bem-sucedida. | integer |
Configuração básica
Para configurar esse componente pré-criado:
- Importe o componente pré-criado.
- Configure o webhook flexível fornecido com os serviços externos. Consulte a configuração do Webhook abaixo.
Configuração do webhook
Para usar esse componente, é preciso configurar os webhooks flexíveis incluídos para recuperar as informações necessárias dos serviços externos.
Mais detalhes da conta
O webhook prebuilt_components_greeting:get_account_details é usado pelo
componente para identificar o autor da chamada usando a ANI. Se o número de telefone do
autor da chamada existir no serviço externo configurado, as informações relevantes
para personalizar a experiência serão recuperadas, incluindo o nome e o e-mail do autor da chamada.
Parâmetros de solicitação de API
Os parâmetros a seguir são fornecidos pelo componente como entradas para a solicitação de API.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| phone_number | Número de telefone do autor da chamada (ANI) | integer |
Parâmetros de resposta da API
Os parâmetros a seguir são extraídos da resposta da API a ser usado pelo componente.
| Nome do parâmetro | Descrição | Formato da saída |
|---|---|---|
| user_first_name | O nome do usuário final, usado para fornecer uma saudação personalizada. | string |
Para configurar o webhook "Ver detalhes da conta" desse componente, abra as instruções.
- Abra o Console do Dialogflow CX.
- Escolha seu projeto do Google Cloud.
- Selecione seu agente.
- Selecione a guia Gerenciar.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_greeting:get_account_details.
- Substitua o URL no campo Webhook URL do Dialogflow pelo endpoint do serviço que você quer integrar. Selecione o Método adequado no menu suspenso.
- Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para o webhook.
- Revise e atualize a Configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, porque eles são exigidos pelo componente para acessar os valores de campo retornados.
- Analise e atualize as configurações da Autenticação conforme necessário.
- Clique em Save.
Concluído
Seu agente e o webhook dele agora estão configurados e prontos para testes.