Componente pré-criado de saudação

O componente predefinido 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 de telefone 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 predefinidos, este componente predefinido tem as seguintes limitações:

  • O componente presume que os números de telefone do cliente são mantidos em um CRM (Gestão de relacionamento com o cliente) ou outro serviço.
  • Os clientes existentes que usam um número de telefone alternativo para entrar em contato não serão autenticados por este componente.

Exemplos de diálogos

As caixas de diálogo de exemplo a seguir 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 de chamada e recebe uma notificação mensagem de saudação.

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?

Usuário final não identificado

O número de chamada do usuário final não é identificado, e o usuário final 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?

Convenções de nomenclatura

Esse componente pré-criado usa as seguintes convenções de nomenclatura:

Recurso Formato Exemplo
Fluxo [Component Name] Saudação
Parâmetro [param_name] 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 serão usados por uma ou mais condições dentro do para determinar como o componente deve se comportar. Os parâmetros com escopo de fluxo precisam ser definido na página inicial do componente, conforme descrito abaixo. No escopo da sessão podem ser definidos por um fluxo de chamada ou no início página desse componente.

Esse componente predefinido aceita os seguintes parâmetros de entrada:

Nome do parâmetro Descrição Formato da entrada
$flow.company_name Captura o nome da empresa que será usado dinamicamente no prompt de saudação. string

Para configurar os parâmetros de entrada deste componente, abra as instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Build.
  5. Clique no componente importado na seção Fluxos.
  6. Clique na página inicial na seção Páginas.
  7. Clique na rota true na página inicial.
  8. Na janela "Rota", edite os valores das configurações predefinidas de parâmetros conforme necessário.
  9. Clique em Salvar.

Parâmetros de saída

Os parâmetros de saída são de sessão que permanecerão ativos depois de sair. do componente. Esses parâmetros contêm informações importantes coletadas pelo componente. Esse componente predefinido 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. booleano
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 ANI foi bem-sucedida. integer

Configuração básica

Para configurar esse componente pré-criado:

  1. Importe o componente pré-criado.
  2. Configure o webhook flexível fornecido com seus serviços externos. Consulte a configuração de webhook abaixo.

Configuração do webhook

Para usar este componente, você precisa configurar o webhooks flexíveis para recuperar informações necessárias dos serviços externos.

Acessar detalhes da conta

O webhook prebuilt_components_greeting:get_account_details é usado pelo componente para identificar o autor da chamada usando o 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 para serem usados pelo componente.

Nome do parâmetro Descrição Formato da saída
user_first_name Nome do usuário final, usado para dar uma saudação personalizada. string

Para configurar o webhook "Get Account Details" para esse componente, abra as instruções.

  1. Abra o console do Dialogflow CX.
  2. Escolha seu projeto do Google Cloud.
  3. Selecione seu agente.
  4. Selecione a guia Gerenciar.
  5. Clique em Webhooks.
  6. Selecione o webhook prebuilt_components_greeting:get_account_details.
  7. Substitua o URL no campo Webhook URL dos Agentes de conversa (Dialogflow CX) pelo endpoint do serviço com que você quer fazer a integração. Selecione o Método adequado no menu suspenso.
  8. Revise e atualize o Corpo da solicitação para formar o formato de solicitação adequado para seu webhook.
  9. Revise e atualize a Configuração de resposta para extrair campos específicos do objeto. resposta. Não modifique os nomes dos parâmetros, porque eles são necessários para que o componente acesse os valores de campo retornados.
  10. Analise e atualize as configurações de Autenticação conforme necessário.
  11. Clique em Salvar.

Concluído

Seu agente e o webhook dele estão configurados e prontos para testes.