Componente pré-criado de saudação

O componente pré-criado de saudação obtem o número de telefone do autor da chamada (ANI), se disponível. Se o número de telefone for obtido, o componente faz uma autenticação simples através do número de telefone, validando-o em relação aos números de telefone registados. Em seguida, o agente cumprimenta o utilizador final com uma mensagem personalizada com base nas informações da respetiva conta.

Limitações

Além das limitações comuns dos componentes pré-criados, este componente pré-criado tem as seguintes limitações:

• O componente pressupõe que os números de telefone dos clientes são mantidos num sistema de CRM (gestão das relações com clientes) ou noutro serviço.
• Os clientes existentes que usam um número de telefone alternativo para entrar em contacto não são autenticados por este componente.

Exemplos de caixas de diálogo

Os exemplos de caixas de diálogo seguintes demonstram cenários comuns processados por este componente pré-criado. Os diálogos de exemplo demonstram o comportamento quando o componente é chamado através da telefonia, o que aciona a intenção de boas-vindas predefinida e a primeira resposta do agente no início da conversa.

Utilizador final autenticado

O utilizador final é identificado com base no número de chamada e recebe uma mensagem de saudação personalizada.

Introdução do utilizador	Resposta do agente
	Olá, [Caller First Name]. Agradecemos o seu contacto com [Nome da empresa]. Estamos empenhados na sua saúde financeira. Como podemos ajudar hoje?

Utilizador final não identificado

O número de chamada do utilizador final não é identificado e o utilizador final recebe a mensagem de saudação padrão.

Introdução do utilizador	Resposta do agente
	Agradecemos o seu contacto com [Nome da empresa]. Estamos empenhados na sua saúde financeira. Como podemos ajudar hoje?

Convenções de nomenclatura

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

Funcionalidade	Formato	Exemplo
Flow	[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 parâmetros usados para configurar determinados comportamentos do componente. Os parâmetros vão ser usados por uma ou mais condições no fluxo para determinar o comportamento do componente. Os parâmetros ao nível do fluxo têm de ser definidos na página inicial do componente, conforme descrito abaixo. Os parâmetros ao nível da sessão podem ser definidos por um fluxo de chamadas ou na página de início deste componente.

Este componente pré-criado aceita os seguintes parâmetros de entrada:

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

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

1. Abra a consola do Dialogflow CX.
2. Escolha o seu projeto do Google Cloud.
3. Selecione o seu agente.
4. Selecione o separador Criar.
5. Clique no componente importado na secção Fluxos.
6. Clique na página inicial na secção Páginas.
7. Clique no percurso verdadeiro na página inicial.
8. Na janela Route, edite os valores de Predefinições de parâmetros conforme necessário.
9. Clique em Guardar.

Parâmetros de saída

Os parâmetros de saída são parâmetros de sessão que permanecem ativos após sair do componente. Estes parâmetros contêm informações importantes recolhidas pelo componente. Este componente pré-criado fornece valores para os seguintes parâmetros de saída:

Nome do parâmetro	Descrição	Formato de saída
ani_auth	Este parâmetro capta o resultado da autenticação baseada no ANI. Por predefinição, o valor é falso.	booleano
auth_level	Indica o nível de autenticação do autor da chamada. Por predefinição, o valor é nulo. -1 indica que o utilizador não foi autenticado pelo respetivo ANI. 0 indica que a autenticação ANI foi bem-sucedida.	número inteiro

Configuração básica

Para configurar este componente pré-criado:

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

Configuração do webhook

Para usar este componente, tem de configurar os webhooks flexíveis incluídos para obter as informações necessárias dos seus serviços externos.

Obtenha os detalhes da conta

O webhook prebuilt_components_greeting:get_account_details é usado pelo componente para identificar o autor da chamada através do respetivo 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 são obtidas, incluindo o nome e o email do autor da chamada.

Parâmetros de pedidos de API

Os seguintes parâmetros são fornecidos pelo componente como entradas para o pedido da API.

Nome do parâmetro	Descrição	Formato de saída
phone_number	Número de telefone do autor da chamada (ANI)	número inteiro

Parâmetros de resposta da API

Os seguintes parâmetros são extraídos da resposta da API para serem usados pelo componente.

Nome do parâmetro	Descrição	Formato de saída
user_first_name	Nome próprio do utilizador final, usado para fornecer uma saudação personalizada.	de string

Para configurar o webhook Get Account Details para este componente, expanda para ver as instruções.

1. Abra a consola do Dialogflow CX.
2. Escolha o seu projeto do Google Cloud.
3. Selecione o seu agente.
4. Selecione o separador Gerir.
5. Clique em Webhooks.
6. Selecione o webhook prebuilt_components_greeting:get_account_details.
7. Substitua o URL no campo URL do webhook dos agentes conversacionais (Dialogflow CX) pelo ponto final do serviço com o qual quer fazer a integração. Selecione o Método adequado no menu pendente.
8. Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
9. Reveja e atualize a configuração de resposta para extrair campos específicos da resposta do webhook. Não modifique os nomes dos parâmetros, uma vez que são necessários para que o componente aceda aos valores dos campos devolvidos.
10. Reveja e atualize as definições de autenticação, conforme necessário.
11. Clique em Guardar.

Concluído

O seu agente e o respetivo webhook já devem estar configurados e prontos para teste.