> For the complete documentation index, see [llms.txt](https://library.zoom.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://library.zoom.com/technical-library/pt/servicos-corporativo-for-plan/zoom-virtual-agent/pci-pal-integration-for-zoom-virtual-agent.md).

# PCI Pal Integrações para Zoom Virtual Agent

Configurar PCI Pal Secure Payments para fluxos de trabalho de link seguro de pagamento no Zoom Virtual Agent.

Este guia explica como Configurar o PCI Pal Secure Payments com Zoom Virtual Agent. Ele aborda a configuração, a configuração do link de pagamento e um exemplo de agente de voz.

### Visão geral

As **Integrações do PCI Pal Secure Payments para Zoom Virtual Agent** introduzem recursos de pagamento seguro diretamente no Zoom Virtual Agent, permitindo fluxos de pagamento orientados por IA sem o envolvimento de agentes humanos.

Quando um cliente interage com um agente virtual de voz ou chat e precisa fazer um pagamento, o Zoom Virtual Agent pode invocar a ferramenta PCI Pal para gerar um link de pagamento seguro. Esse link é então entregue aos clientes via SMS ou e-mail, ou como um link em chat, permitindo que eles concluam o pagamento na página segura e hospedada da PCI Pal.

{% hint style="warning" %}
**Aviso**

Esta integração foi projetada para funcionar enviando um link de pagamento ao cliente, onde o cliente conclui o pagamento pelo link em seu navegador. Esta integração não foi projetada para Permitir que o cliente fale verbalmente ou insira as informações do cartão de pagamento por Dual Tone Multi Frequency (DTMF) no Zoom Virtual Agent.
{% endhint %}

Isso permite que as organizações automatizem jornadas de pagamento de ponta a ponta dentro de um agente virtual, reduzindo a necessidade de transferir clientes para agentes ao vivo para a coleta de pagamento. O agente virtual lida com o fluxo conversacional, identificando clientes, confirmando o valor e coletando detalhes não confidenciais, enquanto a PCI Pal lida com o processamento seguro do pagamento. Em nenhum momento o agente virtual recebe, processa ou armazena quaisquer dados do cartão de pagamento.

### Pré-requisitos

Para usar esta integração, você deve ter:

* Licenças apropriadas para Zoom Virtual Agent (voz e chat).
* Uma conta de usuário com Permissão de administrador para Configurar Zoom Virtual Agent.
* Acessar o AI Studio com Permissão para Adicionar Integrações.

### Configuração inicial

As Integrações do PCI Pal para Zoom Virtual Agent requerem um aplicativo integrado disponível no **AI Studio**, em **Integrações** no menu. Os passos de configuração são apresentados abaixo.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/DSEtA0zgWKGaIhPUUxLu/5d_J6ou3QombLMxU%20Q6wFg" alt=""></div>

{% hint style="info" %}
**Nota**

Você encontrará dois Zoom Apps no Zoom App Marketplace para Integrações do PCI Pal. Cada aplicativo tem um caso de uso diferente.
{% endhint %}

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/NF2vhRQZnxnKcms7dCvx/xTH87EPrRp%20vecX0JvOm8w" alt=""></div>

**Opção 1:**

[**Centrais de contato da solução de pagamento seguro PCI Pal**](https://marketplace.zoom.us/apps/MxNTkUxtQYSja9I-2YbMwQ): esta versão permite que agentes humanos facilitem pagamentos na central de contato Zoom usando o método de Integrações do aplicativo Zoom.

**Opção 2:**

[**Pagamentos Seguros da PCI Pal, Agentes Virtuais do Zoom**](https://marketplace.zoom.us/apps/PlJfA-OkSvGTHAdt82ZF9g): Este aplicativo permite facilitar pagamentos através do Zoom Virtual Agent.

Deverá instalar o aplicativo adequado aos casos de utilização específicos das necessidades da sua implementação. **Não é necessário instalar os dois aplicativos, a menos que as duas integrações de pagamento sejam necessárias.**

{% hint style="info" %}
**Nota**

Para as integrações explicadas neste guia, bem como para o caso de uso de exemplo, tem de ligar o **Pagamentos seguros da PCI Pal, Zoom Virtual Agent** aplicativo no AI Studio, em Integrações. Você não precisa instalar o aplicativo diretamente do Zoom App Marketplace.
{% endhint %}

#### Conectando as Integrações ao Zoom Virtual Agent

1. Navegue até [zoom.com](https://www.zoom.com/) e inicie sessão.
2. Aceda a **AI Studio > Integrações**.
3. Desloque-se até ao fim da página e clique na ligação para **Ver todas as integrações de ferramentas do Marketplace**.
4. Localize o **PCI Pal Secure Payments, Zoom Virtual Agents** aplicativo.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/DSEtA0zgWKGaIhPUUxLu/5d_J6ou3QombLMxU%20Q6wFg" alt=""></div>

4. Clique no **Ligar** botão. Ser-lhe-á pedido que forneça informações sobre a sua conta PCI Pal para concluir a configuração.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/nQmdhDyVDhcrnZB71vj9/IFio5qZ6TlinicaaUVQhmQ" alt="" width="563"></div>

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/0VGRdYOvGSrQIF8p8N8s/fQw0eKinT02SIH5Hxm5LHg" alt="" width="563"></div>

{% hint style="info" %}
**Nota**

A PCI Pal pode fornecer as informações de configuração necessárias nas capturas de tela acima.
{% endhint %}

5. Volte a **AI Studio > Integrações**. Deverá ver que a integração está agora ligada e pronta, com o estado «Ativo».

<div data-with-frame="true"><img src="https://1821044411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FJ3ufvqF3vSzw2DoIGnXi%2FPCI-Pal_ZVA_integrations-active.png?alt=media&amp;token=c2287e9b-36e0-4cd6-80bc-9f7264e77bc7" alt=""></div>

A Integrações da PCI Pal agora está pronta para ser usada pelos seus agentes de voz e chat.

#### Adicionar a Ferramenta a uma Skill

O Zoom Virtual Agent pode fornecer uma experiência de pagamento ao cliente ao invocar uma ferramenta dentro de uma skill.

{% hint style="info" %}
**Nota**

Para obter mais informações sobre como criar ferramentas e competências para o Zoom Virtual Agent, consulte o artigo do Suporte do Zoom [Criar ferramentas do Zoom Virtual Agent](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0081099).
{% endhint %}

Para Adicionar a ferramenta:

1. Crie um novo Virtual Agent ou modifique um existente.
2. Crie ou modifique uma **Competência**.
3. Prima a **/ (barra oblíqua)** tecla para abrir o **menu de variáveis, ferramentas e competências**.
4. Selecionar **Ferramenta**, depois desloque-se para baixo para localizar o **Entrada do Marketplace da PCI Pal**.
5. Selecionar o **PCI\_Pal\_Create\_a\_pagamento\_Link** ferramenta do menu.

<div data-with-frame="true"><img src="https://1821044411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FctBXUMeBy4rtLMmMkKRG%2Fuploads%2FvE9VuAIQGsjHEMWMzWs9%2FPCI-Pal_ZVA_create-skill-newest.png?alt=media&amp;token=1969411a-4bc5-4927-98a8-d1f1b3d3e06f" alt=""></div>

6. Dê um nome e uma descrição à ferramenta.
7. Configurar o **Parâmetros e respostas** informações.

Pode utilizar as tabelas de informações presentes na secção seguinte para Configurar a ferramenta.

**Parâmetros**

Os parâmetros servem como entradas para a ferramenta PCI Pal gerar uma sessão de pagamento. Alguns destes parâmetros são obrigatórios, enquanto outros são Opcionais. Tal como acontece com outras ferramentas que pode estar a utilizar, estas entradas podem ser:

* Valores estáticos
* Mapeados a partir de variáveis
* Recolhidos através de LLM

A lista de campos Disponível nas tabelas seguintes representa todas as informações potenciais que podem ser necessárias para facilitar o pagamento. O cliente deve trabalhar com a PCI Pal e o respetivo Fornecedor de Serviços de Pagamento (PSP) para determinar quais os campos necessários para o seu cenário específico.

{% hint style="success" %}
**Dica**

Se estiver a pedir ao cliente para efetuar um pagamento, é seguro presumir que já identificou quem está a ligar, verificou o estado da encomenda e assim por diante. Utilize competências e ferramentas adicionais para armazenar estas informações com variáveis globais, para referência na ferramenta PCI Pal.
{% endhint %}

| Nome da variável | Requisito   | Descrição                                                                                                                                                                                                                                                                             |
| ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `flowId`         | Obrigatório | <p>O identificador único <code>flowId</code> do seu fluxo de pagamento da PCI Pal. Este número é fornecido no guia de configuração da PCI Pal.</p><ul><li><strong>Nota:</strong> Tem de trabalhar com a PCI Pal para identificar o ID correto para o percurso de pagamento.</li></ul> |
| `reference`      | Obrigatório | Um campo para aplicar uma referência personalizada ao pagamento. Esta será incluída em quaisquer webhooks de pagamento, conforme acordado com a PCI Pal.                                                                                                                              |
| `amount`\*\*     | Obrigatório | <p>O montante a pagar. Forneça-o no formato especificado no seu guia de configuração da PCI Pal.</p><ul><li><strong>Nota:</strong> Só precisa de especificar um valor. Não é necessário indicar a moeda.</li></ul>                                                                    |
| `Moeda`          | Opcional    | A moeda no formato ISO 4217 (USD/GBP). Este é um campo Opcional. Consulte o seu guia de configuração da PCI Pal para obter detalhes ou requisitos.                                                                                                                                    |
| `firstName`      | Obrigatório | O primeiro nome do cliente. Poderá ser-lhe solicitado que envie o primeiro e o último nome do titular do cartão num único campo. Consulte o seu guia de configuração da PCI Pal.                                                                                                      |
| `lastName`       | Obrigatório | O último nome do cliente. Poderá ser-lhe solicitado que envie o primeiro e o último nome do titular do cartão num único campo. Consulte o seu guia de configuração da PCI Pal.                                                                                                        |
| `addressLine1`   | Obrigatório | A primeira linha do endereço do cliente. Forneça-a no formato especificado no seu guia de configuração da PCI Pal.                                                                                                                                                                    |
| `addressLine2`   | Opcional    | A segunda linha do endereço do cliente. Forneça-a no formato especificado no seu guia de configuração da PCI Pal.                                                                                                                                                                     |
| `city`           | Obrigatório | Dados do endereço do cliente. Forneça-os no formato especificado no seu guia de configuração da PCI Pal.                                                                                                                                                                              |
| `state`          | Opcional    | Dados do endereço do cliente. Forneça-os no formato especificado no seu guia de configuração da PCI Pal.                                                                                                                                                                              |
| `zipcode`        | Obrigatório | Dados do endereço do cliente. Forneça-os no formato especificado no seu guia de configuração da PCI Pal.                                                                                                                                                                              |
| `country`        | Opcional    | Dados do endereço do cliente. Forneça-os no formato especificado no seu guia de configuração da PCI Pal.                                                                                                                                                                              |
| `e-mail`         | Opcional    | O endereço de e-mail do cliente. Opcional. Forneça-o apenas se for necessário de acordo com o seu guia de configuração da PCI Pal.                                                                                                                                                    |
| `phoneNumber`    | Opcional    | O número de telefone do cliente. Opcional. Forneça-o apenas se for necessário de acordo com o seu guia de configuração da PCI Pal. O guia também especificará o formato de número necessário.                                                                                         |
| `customData1`    | Opcional    | Um campo de dados adicional Opcional. Quaisquer dados necessários serão especificados no guia de configuração da PCI Pal, juntamente com o formato exigido.                                                                                                                           |
| `customData2`    | Opcional    | Um campo de dados adicional Opcional. Quaisquer dados necessários serão especificados no guia de configuração da PCI Pal, juntamente com o formato exigido.                                                                                                                           |
| `customData3`    | Opcional    | Um campo de dados adicional Opcional. Quaisquer dados necessários serão especificados no guia de configuração da PCI Pal, juntamente com o formato exigido.                                                                                                                           |
| `customData4`    | Opcional    | Um campo de dados adicional Opcional. Quaisquer dados necessários serão especificados no guia de configuração da PCI Pal, juntamente com o formato exigido.                                                                                                                           |
| `customData5`    | Opcional    | Um campo de dados adicional Opcional. Quaisquer dados necessários serão especificados no guia de configuração da PCI Pal, juntamente com o formato exigido.                                                                                                                           |

{% hint style="info" %}
**Nota**

O `additionalField1`, `additionalField2`, e `additionalField3` Os campos são marcadores de posição para valores personalizados. Por exemplo, o PSP de um cliente pode exigir informações específicas sobre o voo, como o aeroporto de origem, o aeroporto de destino e o número do voo. Estes campos permitem recolher essas informações específicas.
{% endhint %}

{% hint style="warning" %}
**\*\*Orientações adicionais para o `amount`** **campo**:

O `amount` campo **tem de** ser preenchido com o montante que o cliente irá pagar.

Existem **dois elementos** a considerar no montante do pagamento: **Moeda** e **Valor**.

| Moeda                                                                                                                                             | Valor                                                                                                              |
| ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| <ul><li>A moeda é baseada no formato ISO4217 (GBP, USD, etc.) e será configurada pelo PCI Pal dentro do fluxo de trabalho de pagamento.</li></ul> | <ul><li>O valor do pagamento e o formato são importantes, e o formato será definido pelo PSP do cliente.</li></ul> |
| <ul><li><strong>Não é necessário incluir a moeda</strong>.</li></ul>                                                                              | <ul><li><strong>O valor tem de estar no formato correto</strong>.</li></ul>                                        |

O PSP pode exigir que o valor seja definido usando a menor unidade de medida possível, como pence, centavos e assim por diante. Isso ajuda a evitar a possibilidade de erros de matemática decimal. Por exemplo:

* 100 = 100 pence = £1
* 1638 = 1638 centavos = $16.38

**Tem de trabalhar com a PCI Pal e o seu PSP para determinar como será apresentado o montante do pagamento durante o fluxo de pagamento**.
{% endhint %}

{% hint style="success" %}
**Dica**:

Capturar o número de telefone e o endereço de e-mail do cliente facilita a entrega do link de pagamento. Combine a skill do PCI Pal com a ferramenta SMS e/ou e-mail para enviar o link ao cliente (particularmente útil para casos de uso de agente de voz).
{% endhint %}

**Respostas**

| Nome da variável     | Requisito   | Descrição                                                                                                                                                                            |
| -------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Id`                 | Opcional    | O identificador exclusivo (GUID) da sessão de pagamento gerada. Isso é usado principalmente para registro e para fornecê-lo ao Suporte do PCI Pal para fins de solução de problemas. |
| `LinkId`             | Opcional    | Não é necessário para a implementação atual, mas incluído para possível uso futuro.                                                                                                  |
| `DigitalSessionLink` | Obrigatório | O link da sessão de pagamento                                                                                                                                                        |

{% hint style="info" %}
**Nota**

O campo `DigitalSessionLink` contém o link de pagamento de que o cliente precisará. Use a ferramenta de SMS ou e-mail para enviar o link para um número de telefone ou endereço de e-mail obtido durante o contato com o cliente.
{% endhint %}

### Usando o Agente de Voz

Esta seção mostrará a você uma configuração de exemplo prática de um fluxo de trabalho de pagamento usando um agente de voz. Este passo a passo também se aplica a agentes de chat do Zoom Virtual Agent.

Neste exemplo, o cliente está ligando para descobrir onde está o pedido, e o agente de voz informa que o pedido foi atrasado por causa de um saldo em aberto. O agente então oferece ao cliente a oportunidade de quitar o saldo usando o fluxo de trabalho de pagamento do PCI Pal.

Para este exemplo, você precisará de:

* Uma configuração de SMS funcional no Zoom central de contato
* Uma conta de e-mail vinculada ao Zoom Virtual Agent
* Um repositório de base de conhecimento existente

{% hint style="info" %}
**Nota**

A configuração de SMS para a central de contato Zoom, a associação de uma conta de e-mail ao Zoom Virtual Agent e a configuração de uma base de conhecimento estão fora do escopo deste documento. Consulte o [Suporte do Zoom](https://support.zoom.com/hc/en) para obter mais informações.
{% endhint %}

#### Criando um Agente de Voz

Para este caso de uso, você criará um agente de voz simples:

1. Inicie sessão no Centro de administração do Zoom.
2. No lado esquerdo da tela, Selecionar **Configuração do produto > AI Studio > Agentes virtuais**.
3. Clique no botão de menu suspenso **Adicionar agente virtual** e Selecionar **Baseado em instruções**.
4. Clique em **Começar do zero** na janela pop-up que aparece.
5. Crie um novo agente de voz **Baseado em instruções** a partir de um modelo em branco.
6. Inserir os seguintes detalhes na janela do fluxo de trabalho **Criar agente** :
   1. Clique na modalidade **chat** para desmarcá-la. Neste exemplo, apenas a modalidade de voz é necessária.
   2. No campo de texto **Nome do agente** , Inserir "Agente de pedidos". Clique em **Próximo(a)**.
   3. **Orientação**: "Você é um agente cordial responsável por ajudar os clientes com seus pedidos e pagamentos. As APIs vão apresentar os saldos pendentes em pence. Ao apresentá-los a um cliente, você deve lê-los em libras e pence (por exemplo, 1000 é £10), mas não altere o valor retornado pela API." Clique em **Próximo(a)**.
   4. Selecionar a voz e o idioma principais do seu agente entre as opções disponíveis. Clique em **Próximo(a)**.
   5. Selecionar uma base de conhecimento na lista **Usar fonte existente** . Clique em **Próximo(a)**.
   6. (Opcional) Escolher uma das skills Disponível da etapa final do fluxo de trabalho.
   7. Clique em **Criar**.

{% hint style="info" %}
**Nota**

Um agente de produção incluiria orientações e guardrails abrangentes. Neste exemplo, o foco está em criar a jornada de pagamento. Este agente de exemplo não inclui guardrails adicionais.
{% endhint %}

#### Configurando Variáveis Globais

Você precisará de várias variáveis para facilitar este caso de uso. Configurar estas da seguinte forma:

1. Inicie sessão no Centro de administração do Zoom.
2. Acesse **AI Studio → Agentes virtuais**.
3. Clique na aba **Preferências** na parte superior da tela.
4. Clique em **Variáveis** ícone.
5. Crie um grupo de variáveis personalizado clicando na ligação **+Adicionar grupo personalizado** no fundo da coluna.
6. Dê ao grupo de variáveis personalizado o nome "**pagamento**."
7. Clique em **Adicionar**.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/DXq8qXjjaFBQFYvcGz74/u7rlhrq7QtST0ArDSeXs2A" alt="" width="563"></div>

8. Clique no grupo personalizado que acabou de criar e, em seguida, clique em **+Adicionar variável** no canto superior direito da tela.
9. Crie as seguintes variáveis:

| Nome da variável | Tipo                 | Valor      |
| ---------------- | -------------------- | ---------- |
| e-mail           | Cadeia de caracteres | Indefinido |
| telefone         | Cadeia de caracteres | Indefinido |
| link clicável    | Cadeia de caracteres | Indefinido |

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/lUEIdN2SnrSuvxGVZ9OS/IZU9LAQ0Qte8Kop2zhMWLg" alt=""></div>

#### Editando o Agente de Voz Existente

Depois de configurar as variáveis, você precisará retornar ao agente de voz e criar skills para facilitar a busca de pedidos e pagamentos seguros.

1. Aceda a **Estúdio de IA → Agentes virtuais → Agentes**.
2. Modifique o agente de voz que você criou anteriormente.
3. Desloque-se para baixo até **Competências** na configuração do agente de voz.
4. Passe para as seções Próximo(a) para criar duas skills.

**Criando uma Skill de Atualização de Pedido**

Próximo(a), crie uma skill para fornecer aos Clientes/clientes informações sobre seus pedidos recentes. Você usará código JavaScript estático para simular um ligar de API e retornar informações fictícias do pedido.

1. Clique em **+Criar competência** e crie uma **competência baseada em instruções**.
2. Inserir os seguintes detalhes:
   1. Nome: Obter detalhes do pedido
   2. Gatilho: Use esta skill para recuperar informações sobre um pedido recente
3. Na janela Instruções, prima a tecla **/ (barra oblíqua)** .
4. Selecionar **Ferramenta** e clique em **Criar uma nova ferramenta**.
5. Clique em **Script personalizado**.
6. Inserir os seguintes detalhes:
   1. Nome: `get_order_details`
   2. Descrição: Para recuperar informações sobre pedidos
   3. JavaScript: Use o bloco de código abaixo:

```javascript
async function main() {
  return {
    "firstName": "Ben",
    "lastName": "Williams",
    "deliveryAddress": "71 MidCity Place",
    "city": "Londres",
    "postcode": "WC1V 6EA",
    "orderStatus": "atrasado",
    "statusReason": "saldo pendente",
    "outstandingBalance": "12557"
  }
}
```

Este código irá simular uma ação de ligar à API, fornecendo detalhes sobre um pedido fictício com um saldo pendente. As informações nesta resposta serão usadas nos parâmetros configurados como 'Collect via LLM' quando você criar a ferramenta PCI de pagamento.

7. Clique em **Criar**.
8. Complete as instruções da skill usando o texto a seguir:

```plaintext
1. Peça ao cliente o número do pedido
2. Recupere os detalhes do pedido
3. Forneça informações ao cliente
```

9. A configuração da sua skill deve ser como a imagem a seguir:

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/Zds5crLZ34meVO1AHwz0/x2MUvzTjR2CMfuQqHMMEmw" alt="" width="563"></div>

10. Clique em **Adicionar**.

**Criando uma skill de pagamento**

Próximo(a), você criará uma skill que usa a ferramenta pré-criada PCI Pal Marketplace para gerar um link seguro de pagamento. Isso envia o link ao cliente, que então pode fornecer informações de pagamento na página segura de pagamento.

{% hint style="success" %}
**Dica**

Quando a competência Atualização de Pedido identifica um saldo em aberto, o agente virtual pode invocar automaticamente esta competência.
{% endhint %}

1. Clique em **+Criar competência** e selecione a opção para criar uma **competência baseada em instruções**.
2. Inserir os seguintes detalhes:
   1. Nome: Receber pagamento
   2. Acionador: Quando o cliente precisa pagar por bens ou serviços
3. Na janela Instruções, prima a tecla **/ (barra oblíqua)** .
4. Selecionar **ferramenta**, e depois desloque para baixo até localizar a entrada do PCI Pal no Marketplace.
5. Selecionar **PCI Pal - Criar um link de pagamento** ferramenta do menu.
6. Inserir os seguintes detalhes:
   1. Nome: `create_payment_link`
7. Desloque-se para baixo até **Parâmetros** secção.
8. Elimine todos os parâmetros opcionais, exceto `addressLine2`, `state`, `e-mail`, e `phoneNumber`, depois Configurar os parâmetros da seguinte forma:

{% hint style="info" %}
**Nota**

Quaisquer campos não listados na tabela seguinte devem ser eliminados da ferramenta. Os campos não listados não são necessários para este caso de utilização.
{% endhint %}

<table><thead><tr><th width="142">Nome</th><th>Origem do valor</th><th width="104">Definir valor</th><th width="90">Valor</th><th>Mapear para variável</th></tr></thead><tbody><tr><td><code>flowId</code></td><td>Definir manualmente</td><td>valor estático</td><td>2213</td><td>N/D</td></tr><tr><td><code>reference</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td>N/D</td></tr><tr><td><code>amount</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td>N/D</td></tr><tr><td><code>firstName</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td>N/D</td></tr><tr><td><code>lastName</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td>N/D</td></tr><tr><td><code>addressLine1</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td>N/D</td></tr><tr><td><code>addressLine2</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td>N/D</td></tr><tr><td><code>city</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td>N/D</td></tr><tr><td><code>state</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td>N/D</td></tr><tr><td><code>zipcode</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td>N/D</td></tr><tr><td><code>e-mail</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td><code>global_custom.pagamento.e-mail</code></td></tr><tr><td><code>phoneNumber</code></td><td>Recolhidos através de LLM</td><td>N/D</td><td>N/D</td><td><code>global_custom.pagamento.phone</code></td></tr></tbody></table>

9. Desloque-se para baixo até à **Resposta** secção.
10. Elimine todos os parâmetros exceto `DigitalSessionLink` que deve então Configurar da seguinte forma:
    1. Descrição: O link de pagamento único
    2. Mapear para a variável: `global_custom.pagamento.link`
11. Clique **Guardar e adicionar**.
12. Na janela Instruções, prima o **/ (barra oblíqua)** chave novamente.
13. Adicionar o **SMS** ferramenta e Configurar da seguinte forma:
    1. Número de telefone do remetente: Selecionar um número adequado na lista pendente.
    2. Número do destinatário: Da variável
    3. Variável: `global_custom.pagamento.phone`
    4. Conteúdo: Por favor, use este link seguro de pagamento
       1. Imprensa o **/ (barra oblíqua)** chave no fim desta string e localize o `global_custom.pagamento.link` variável.
14. A ferramenta SMS deve parecer semelhante à seguinte imagem:

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/w8KGYua82UYwmlLSemH5/wwn4xbqQTp2Y18mx8rFSng" alt=""></div>

15. Clique **Guardar e adicionar**.
16. Na janela Instruções, prima o **/ (barra oblíqua)** chave novamente.
17. Adicionar o **e-mail** ferramenta e Configurar da seguinte forma:
    1. Conta de e-mail do remetente: Selecionar uma das suas contas de e-mail ligadas.
    2. Endereço de e-mail do destinatário: `global_custom.pagamento.e-mail`
    3. Modelo de e-mail:
       1. Assunto: O seu link seguro de pagamento
       2. Corpo: Por favor, use este link seguro de pagamento
          1. Imprensa o **/ (barra oblíqua)** chave no fim desta string e localize o `global_custom.pagamento.link` variável.
18. A ferramenta de e-mail deve parecer com a seguinte imagem:

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/83kXiVtXnymyHAsV98i3/hvbg6qgmSwCScq3Jbn0qBQ" alt=""></div>

19. Clique **Guardar e adicionar**.
20. Complete as instruções da skill usando o texto a seguir:

```plaintext
1. Pergunte ao cliente se ele prefere receber o link de pagamento via e-mail ou SMS.
2. Confirme o valor que ele irá pagar.
3. Se pedirem SMS, solicite o número de telefone. Caso contrário, solicite o endereço de e-mail.
4. Envie um SMS ou um e-mail, dependendo da preferência deles. Não ambos. 
```

21. A configuração da sua skill deve ser como a imagem a seguir:

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/tIB4UaRKRvqn7ZFx1Nwm/7BLLVYiaQnWUYZRO0NoacQ" alt="" width="563"></div>

22. Clique em **Adicionar**.

### Testar o Agente de Voz

Nesta altura, está pronto para testar o agente de voz. Na janela de pré-visualização, clique em **Iniciar teste** botão para iniciar uma conversa com o agente de voz.

<div data-with-frame="true"><img src="https://content.gitbook.com/content/ctBXUMeBy4rtLMmMkKRG/blobs/sXXyxa9OhWr1l9Tno87o/tDCyV7buQx69AyO1hQIh_A" alt=""></div>

{% hint style="info" %}
**Nota**

Pode usar qualquer número para o número da encomenda. A mesma encomenda será devolvida sempre. O número da encomenda que inserir será usado como referência de pagamento pela ferramenta de pagamento da PCI Pal.
{% endhint %}

Segue-se um exemplo de diálogo entre o agente e o cliente para referência:

> **Agente:** Olá! Obrigado por ligar. Sou o seu assistente virtual. Como posso ajudar hoje?
>
> **Cliente:** Olá, a minha encomenda ainda não chegou. Pode verificar o que se passa, por favor?
>
> **Agente:** Claro, posso ajudar. Pode indicar-me o número da sua encomenda, por favor?
>
> **Cliente:** Sim, é 1234.
>
> **Agente:** Obrigado. Vou verificar o que se passa.
>
> **Agente:** A sua encomenda está atrasada porque existe um saldo em dívida de cento e vinte e cinco libras e cinquenta e sete pence.
>
> **Agente:** Gostaria de pagar este valor agora para libertar a sua encomenda?
>
> **Cliente:** Sim, por favor.
>
> **Assistente:** Obrigado. Vou ajudá-lo a tratar disso.
>
> **Assistente:** Gostaria de receber a ligação de pagamento por e-mail ou por mensagem de texto?
>
> **Cliente:** Por e-mail, por favor.
>
> **Assistente:** Pode fornecer o seu endereço de e-mail para que eu possa enviar o link de pagamento?
>
> **Cliente:** Sim, é <example@example-e-mail.com>.
>
> **Agente:** Obrigado. Por favor, confirme: pagará cento e vinte e cinco libras e cinquenta e sete pence. Está correto?
>
> **Cliente:** Sim.
>
> **Agente:** Obrigado por confirmar. Também preciso do seu número de telefone para processar o pagamento. Poderia fornecê-lo, por favor?
>
> **Cliente:** Sim, é 555-555-1234.
>
> **Agente:** Obrigado por fornecer o seu número de telefone. O link de pagamento será enviado para o seu endereço de e-mail. Consulte a sua caixa de entrada e siga o link para pagar cento e vinte e cinco libras e cinquenta e sete pence.

{% hint style="warning" %}
**Aviso**

Observe como o agente de voz identifica que o cliente tem um saldo em aberto e muda automaticamente para a skill de pagamento.
{% endhint %}

Para concluir o teste, verifique sua conta de SMS de teste ou conta de e-mail e clique no link de pagamento. Quando solicitado, você pode usar os seguintes dados do cartão:

* **Número do cartão**: 1111 2222 3333 4444
* **Validade**: Qualquer mês/ano de 4 dígitos no futuro (por exemplo, 1228)
* **Código de segurança**: Qualquer número de 3 dígitos (por exemplo, 123)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://library.zoom.com/technical-library/pt/servicos-corporativo-for-plan/zoom-virtual-agent/pci-pal-integration-for-zoom-virtual-agent.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
