O componente pré-criado agendar compromisso permite que os clientes novos e existentes agendem compromissos. Este componente usa uma versão personalizada do componente pré-criado Recolha da data de nascimento para recolher datas de compromissos e usa os componentes pré-criados Recolha do número de telefone e Recolha do código postal para recolher informações sobre o utilizador e a localização do compromisso.
Motivos e tipos de reuniões
Este componente suporta várias categorias de motivos de compromissos e oferece diferentes tipos de compromissos consoante o motivo selecionado pelo utilizador.
| Motivo da reunião | Tipos de compromissos disponíveis |
|---|---|
| Empréstimos | Presencial, virtual e por telefone |
| Hipotecas | Presencial, virtual e por telefone |
| Gestão de riqueza | Presencial, virtual e por telefone |
| Cartões de crédito | Virtual, telemóvel |
| Outro | Telefone |
As categorias de compromissos podem ser personalizadas modificando a prebuilt_components_arrange_appt_reasonentidade personalizada. Os tipos de compromissos disponíveis para cada categoria podem ser configurados
modificando os parâmetros de entrada
para cada tipo de compromisso.
Limitações
Além das limitações comuns dos componentes pré-criados, este componente pré-criado tem as seguintes limitações:
- Este componente não encripta dados.
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.
O utilizador existente marca uma reunião presencial
O agente identifica que o utilizador foi autenticado anteriormente como um utilizador existente. O utilizador indica o motivo da reunião e seleciona a opção para agendar uma reunião presencial. O agente confirma que o utilizador quer ir à filial mais próxima da respetiva morada registada e confirma que a data e a hora preferenciais do utilizador estão disponíveis. O agente confirma a hora e o local e agenda com êxito a reunião.
| Introdução do utilizador | Resposta do agente |
|---|---|
| Antes de agendar uma reunião, vamos fazer-lhe algumas perguntas. Pode indicar o motivo da sua marcação? | |
| Quero falar com alguém sobre gestão de património | |
| Procura um compromisso por telefone, videochamada ou presencial numa das nossas sucursais? | |
| Quero ir pessoalmente | |
| OK. Quer agendar uma reunião na filial localizada em 1600 Amphitheatre Pkwy, Mountain View, CA 94043? | |
| Sim | |
| Indique a data que prefere para a marcação. Diga o mês preferido, seguido do dia e, depois, do ano. Lembre-se de que as nossas filiais estão abertas de segunda a sexta-feira: das 09:00 às 17:00, e sábado: das 09:00 às 13:00. | |
| O agente recolhe a data preferencial do compromisso do utilizador através do componente pré-criado Recolha da data de nascimento | |
| Ótimo, terminámos de recolher a sua data preferencial. Indique o horário preferencial. |
|
| 10:00 | |
| Selecionou as 10:00. Diga sim para continuar com a hora do compromisso selecionada. | |
| Sim | |
| Vamos agendar uma reunião no endereço do banco 1600 Amphitheatre Pkwy, Mountain View, CA 94043 a 23/09/2023 às 10:00. Está correto? | |
| Sim | |
| OK, agendámos a reunião. O seu número de confirmação é 818452. Quer agendar outro compromisso? | |
| Não, é tudo | |
| Agradecemos o seu contacto. Tenha um bom dia! |
Novo cliente marca várias reuniões
O agente identifica que o utilizador não foi autenticado anteriormente e recolhe o número de telefone do utilizador. O utilizador pede uma reunião virtual para discutir empréstimos. A primeira preferência do utilizador para a data e a hora não está disponível, pelo que o agente oferece horários disponíveis ao utilizador. O utilizador seleciona um horário disponível e o compromisso é agendado com êxito. O utilizador confirma que quer marcar uma segunda reunião e o agente agenda com êxito uma segunda reunião.
| Introdução do utilizador | Resposta do agente |
|---|---|
| O agente recolhe o número de telefone do utilizador através do componente pré-criado Recolha de número de telefone | |
| Ótimo, terminámos de recolher o número de telefone. Antes de agendar uma reunião, vamos fazer-lhe algumas perguntas. Pode indicar o motivo da sua marcação? |
|
| Quero pedir um empréstimo | |
| Procura um compromisso por telefone, videochamada ou presencial numa das nossas sucursais? | |
| A reunião virtual está bem | |
| Indique a data que prefere para a marcação. Diga o mês preferido, seguido do dia e, depois, do ano. Lembre-se de que as nossas filiais estão abertas de segunda a sexta-feira: das 09:00 às 17:00, e sábado: das 09:00 às 13:00. | |
| O agente recolhe a data preferencial do compromisso do utilizador através do componente pré-criado Recolha da data de nascimento | |
| Ótimo, terminámos de recolher a sua data preferencial. Indique o horário preferencial. |
|
| As 15:00 seria bom para mim | |
| Selecionou as 15:00. Para continuar com a hora do compromisso selecionada, diga sim. | |
| Sim | |
| Vamos agendar uma reunião com o nosso consultor a 03/10/2023 às 15:00. Está correto? | |
| Sim | |
| OK, agendámos a reunião. O seu número de confirmação é 754731. Quer agendar outra consulta? |
|
| Sim | |
| Antes de agendar uma reunião, vamos fazer-lhe algumas perguntas. Pode indicar o motivo da sua marcação? | |
| Preciso de uma marcação para o meu cartão de crédito | |
| Procura um compromisso por telefone ou videochamada com um dos nossos representantes da sucursal? | |
| Telefone | |
| Indique a data que prefere para a marcação. Diga o mês preferido, seguido do dia e, depois, do ano. Lembre-se de que as nossas filiais estão abertas de segunda a sexta-feira: das 09:00 às 17:00, e sábado: das 09:00 às 13:00. | |
| O agente recolhe a data preferencial do compromisso do utilizador através do componente pré-criado Recolha da data de nascimento | |
| Ótimo, terminámos de recolher a sua data preferencial. Indique o horário preferencial. |
|
| Às 8:00 serve? | |
| Selecionou as 08:00. Para continuar com a hora do compromisso selecionada, diga sim. | |
| Sim | |
| Lamentamos, mas o horário selecionado não está disponível. Temos disponibilidade para as 11:30, 12:30, 13:30 e 15:00 a 06-10-2023. Quer alterar o intervalo de tempo ou agendar uma reunião noutra data? | |
| OK, vamos fazer às 1:30 | |
| Selecionou as 13:30. Para continuar com a hora do compromisso selecionada, diga sim. | |
| Sim | |
| Vamos agendar uma reunião com o nosso consultor a 06/10/2023 às 13:30. Está correto? | |
| Sim | |
| OK, agendámos a reunião. O seu número de confirmação é 714637. Quer reservar outro compromisso? |
|
| Não, é só isso | |
| Agradecemos o seu contacto. Tenha um bom dia! |
Convenções de nomenclatura
Este componente pré-criado usa as seguintes convenções de nomenclatura:
| Funcionalidade | Formato | Exemplo |
|---|---|---|
| Flow | [Component Name] | Organize uma reunião |
| Intenção específica do componente | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_arrange_appt_change_date_slot |
| Tipo de entidade | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_arrange_appt_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_arrange_appointment:submit_appointment |
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 |
|---|---|---|
| $session.params.phone_number | (Opcional) Número de telefone registado do cliente usado para autenticação. | de string |
| $session.params.auth_level | (Opcional) Indica o nível de autenticação do autor da chamada. | número inteiro |
| $flow.all_appointment_type | Especifica a lista de motivos de compromissos para os quais todos os tipos de compromissos estão disponíveis. O valor predefinido é ["loans", "wealth"]. |
Lista (string) |
| $flow.video_phone_appointment_type | Especifica a lista de motivos de compromissos para os quais todos os tipos de compromissos estão disponíveis. O valor predefinido é ["cards"]. |
Lista (string) |
| $flow.appointment_services | Especifica a lista de tipos de compromissos para os quais a localização da filial não é necessária e não é recolhida do utilizador. O valor predefinido é ["video", "phone"]. |
Lista (string) |
| $flow.working_hours | Especifica o horário de funcionamento da filial, por exemplo, "Monday to Friday: 9 AM to 5 PM, Saturday: 9 AM to 1 PM". |
de string |
| $session.params.arrange_appointment_max_days | Especifica o número máximo de dias após a data atual permitidos para o agendamento de uma reunião. Por predefinição, este valor é 90, o que indica que as datas de compromissos podem ser reservadas no máximo 90 dias após a data atual. Este parâmetro é definido na rota da página inicial true. |
número inteiro |
| flow.max_retry_count | Especifica o número de novas tentativas permitidas ao recolher informações do utilizador. O valor predefinido é 3. |
número inteiro |
Para configurar os parâmetros de entrada deste componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Criar.
- Clique no componente importado na secção Fluxos.
- Clique na página inicial na secção Páginas.
- Clique no percurso verdadeiro na página inicial.
- Na janela Route, edite os valores de Predefinições de parâmetros conforme necessário.
- 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 |
|---|---|---|
| phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
| transfer_reason | Este parâmetro indica o motivo pelo qual o fluxo foi terminado, se não tiver sido bem-sucedido. O valor devolvido é um dos seguintes:agent: o utilizador final pediu um agente humano em algum momento durante a conversa.denial_of_information: o utilizador final recusou-se a partilhar informações pedidas pelo componente.max_no_input: a conversa atingiu o número máximo de novas tentativas para eventos sem introdução. Consulte os eventos incorporados sem entrada.max_no_match: a conversa atingiu o número máximo de novas tentativas para eventos sem correspondência. Consulte os eventos incorporados sem correspondência.webhook_error: ocorreu um erro de webhook. Veja o evento incorporado webhook.error. webhook_not_found: não foi possível aceder a um URL de webhook. Veja o evento incorporado webhook.error.not-found. |
de string |
Configuração básica
Para configurar este componente pré-criado:
- Importe o componente pré-criado.
- Configure os webhooks flexíveis fornecidos com a configuração que descreve 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.
Obter conta
O webhook prebuilt_components_arrange_appointment:get_account é usado pelo componente para obter detalhes da conta para um número de telefone fornecido, se existir uma conta registada.
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 entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
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 |
|---|---|---|
| account_count | Número de contas associadas ao número de telefone registado. | número inteiro |
| cards_count | Número de cartões associados ao número de telefone registado. | número inteiro |
| loans_count | Número de empréstimos associados ao número de telefone registado. | número inteiro |
| mortgage_count | Número de hipotecas associadas ao número de telefone registado. | número inteiro |
| branch_code | Código da filial associado ao número de telefone registado, usado para identificar uma localização de filial exclusiva. | de string |
Para configurar o webhook Get account para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_arrange_appointment:get_account.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Get branch
O webhook prebuilt_components_arrange_appointment:get_branch é usado pelo componente para obter informações sobre a localização de uma filial, dado um código da filial.
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 entrada |
|---|---|---|
| $flow.branch_code | Código da agência que identifica uma localização de agência única. | de string |
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 |
|---|---|---|
| branch_address | Morada da filial. | de string |
Para configurar o webhook Get branch para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_arrange_appointment:get_branch.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Ramo disponível
O webhook prebuilt_components_arrange_appointment:available_branch é usado
pelo componente para obter a localização da filial mais próxima, dado um código postal.
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 entrada |
|---|---|---|
| $flow.zip_code | Código postal fornecido pelo utilizador final. | de string |
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 |
|---|---|---|
| branch_address | Morada da filial. | de string |
Para configurar o webhook de ramificação disponível para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_arrange_appointment:available_branch.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Obtenha horários disponíveis
O webhook prebuilt_components_arrange_appointment:get_available_slots é usado pelo componente para verificar as horas disponíveis para a data e o tipo de compromisso preferidos de um utilizador.
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 entrada |
|---|---|---|
| $flow.preferred_date | Data preferencial para o compromisso fornecida pelo utilizador final no formato "AAAA-MM-DD". | de string |
| $flow.appointment_type | O tipo de marcação da marcação. | de string |
| $flow.branch_code | Código da filial que identifica a localização exclusiva da filial selecionada pelo utilizador final. | de string |
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 |
|---|---|---|
| available_slots | Lista de horas disponíveis para a data especificada, no formato "HH:MM XM", por exemplo, ["09:00 AM", "2:30 PM"]. Se não existirem espaços disponíveis, este parâmetro é uma lista vazia []. |
Lista (string) |
Para configurar o webhook Get available slots para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_arrange_appointment:get_available_slots.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Enviar compromisso
O webhook prebuilt_components_arrange_appointment:submit_appointment é usado pelo componente para agendar uma reunião para a data, a hora, a filial, o motivo da reunião e o tipo de reunião selecionados pelo utilizador.
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 entrada |
|---|---|---|
| $session.params.phone_number | Número de telefone local do utilizador, sem o indicativo do país, usado para identificar o utilizador. | de string |
| $flow.preferred_date | Data preferencial para o compromisso fornecida pelo utilizador final no formato "AAAA-MM-DD". | de string |
| $flow.preferred_slot | Hora preferencial para o compromisso fornecida pelo utilizador final no formato "HH:MM XM". | de string |
| $flow.appointment_reason | O motivo da reunião. | de string |
| $flow.appointment_type | O tipo de marcação da marcação. | de string |
| $flow.branch_code | Código da filial que identifica a localização exclusiva da filial selecionada pelo utilizador final. | de string |
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 |
|---|---|---|
| request_number | O número do pedido da reunião agendada. | número inteiro |
Para configurar o webhook de envio de compromissos para este componente, expanda para ver as instruções.
- Abra a consola do Dialogflow CX.
- Escolha o seu projeto do Google Cloud.
- Selecione o seu agente.
- Selecione o separador Gerir.
- Clique em Webhooks.
- Selecione o webhook prebuilt_components_arrange_appointment:submit_appointment.
- 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.
- Reveja e atualize o corpo do pedido para formar o formato de pedido adequado para o seu webhook.
- 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.
- Reveja e atualize as definições de autenticação, conforme necessário.
- Clique em Guardar.
Concluído
O seu agente e os respetivos webhooks já devem estar configurados e prontos para teste.