> 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/nl/zakelijke-services/zoom-virtual-agent/pci-pal-integration-for-zoom-virtual-agent.md).

# PCI Pal Integratie(s) voor Zoom Virtual Agent

Configureer PCI Pal Secure Betaling(en) voor workflows met beveiligde Betaling-links in Zoom Virtual Agent.

Deze handleiding legt uit hoe u PCI Pal Secure Payments met Zoom Virtual Agent configureert. Het behandelt de setup, configuratie van de betalingslink en een voorbeeld van een voice-agent.

### Overzicht

De **Integratie(s) van PCI Pal Secure Payments voor Zoom Virtual Agent** voegt mogelijkheden voor veilige Betaling rechtstreeks toe aan Zoom Virtual Agent, waardoor AI-gestuurde betaalprocessen mogelijk worden zonder tussenkomst van een menselijke medewerker.

Wanneer een klant interacteert met een virtuele voice- of chatagent en een betaling moet doen, kan Zoom Virtual Agent de PCI Pal-tool aanroepen om een veilige betalingslink te genereren. Deze link wordt vervolgens via sms of E-mail, of als een link in chatbericht, aan klanten geleverd, zodat zij de betaling kunnen voltooien op de beveiligde, gehoste pagina van PCI Pal.

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

Deze integratie is ontworpen om te werken door een betalingslink naar de klant te sturen, waarna de klant de betaling voltooit via de link in hun web Browser. Deze integratie staat de klant niet toe om mondeling te spreken of hun betaalkaartgegevens in te voeren via Dual Tone Multi Frequency (DTMF) naar Zoom Virtual Agent.
{% endhint %}

Dit stelt organisaties in staat om end-to-end betalingsreizen binnen een virtuele agent te automatiseren, waardoor de noodzaak om klanten door te verbinden naar live agents voor betalingsinning afneemt. De virtuele agent beheert de gespreksstroom, identificeert klanten, bevestigt het bedrag en verzamelt niet-gevoelige details, terwijl PCI Pal de veilige betalingsverwerking afhandelt. Op geen enkel moment ontvangt, verwerkt of bewaart de virtuele agent betaalkaartgegevens.

### Vereisten

Om deze integratie te gebruiken, moet u beschikken over:

* Geschikte licenties voor Zoom Virtual Agent (spraak en chatbericht).
* Een gebruikersaccount met beheerdersrechten om Zoom Virtual Agent te configureren.
* Access tot AI Studio met Toestemming om integraties toe te voegen.

### Eerste installatie

Voor de PCI Pal-Integratie(s) voor Zoom Virtual Agent is een geïntegreerde app vereist die Beschikbaar is in **AI Studio**, onder het menu **Integratie(s)** . De installatiestappen staan hieronder.

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

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

U vindt twee Zoom Apps in de Zoom App Marketplace voor PCI Pal Integratie(s). Elke app heeft een ander gebruiksscenario.
{% endhint %}

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

**Optie 1:**

[**PCI Pal-oplossing voor veilige Betaling voor contactcenters**](https://marketplace.zoom.us/apps/MxNTkUxtQYSja9I-2YbMwQ): Met deze versie kunnen menselijke medewerkers in Zoom contactcenter Betaling faciliteren via de Zoom App-Integratie(s)-methode.

**Optie 2:**

[**PCI Pal Secure Payments, Zoom Virtual Agents**](https://marketplace.zoom.us/apps/PlJfA-OkSvGTHAdt82ZF9g): Deze app maakt Betaling via Zoom Virtual Agent mogelijk.

Installeer de juiste app voor de toepassingen die aansluiten op uw implementatiebehoeften. **U hoeft niet beide apps te installeren, tenzij beide integraties voor Betaling nodig zijn.**

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

Voor de integraties die in deze handleiding worden uitgelegd en voor de voorbeeldtoepassing moet u de **PCI Pal Secure Payments, Zoom Virtual Agent** app verbinden in AI Studio onder Integraties. U hoeft de app niet rechtstreeks vanuit de Zoom App Marketplace te installeren.
{% endhint %}

#### Verbinden van de Integratie(s) met Zoom Virtual Agent

1. Ga naar [zoom.com](https://www.zoom.com/) en meld u aan.
2. Ga naar **AI Studio > Integraties**.
3. Scrol naar de onderkant van de pagina en klik op de link **Alle integraties van Marketplace-tools bekijken**.
4. Zoek de **PCI Pal Secure Payments, Zoom Virtual Agents** app.

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

4. Klik op **Verbinden** om de installatie te voltooien. Je wordt gevraagd om gegevens over je PCI Pal-account op te geven.

<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" %}
**Opmerking**

PCI Pal kan u de configuratie-informatie leveren die vereist is in de bovenstaande screenshots.
{% endhint %}

5. Ga terug naar **AI Studio > Integratie(s)**. Je ziet dat de Integratie(s) nu is verbonden en gereed is met de status 'Actief'.

<div data-with-frame="true"><img src="https://3901650588-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>

De PCI Pal-Integratie(s) zijn nu klaar om te worden gebruikt door uw spraak- en chatberichtagenten.

#### Toevoegen van de tool aan een skill

Zoom Virtual Agent kan de klant een Betalingservaring bieden door vanuit een skill een tool aan te roepen.

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

Zie voor meer informatie over het maken van tools en vaardigheden voor Zoom Virtual Agent het artikel van Zoom-ondersteuning [Tools voor Zoom Virtual Agent maken](https://support.zoom.com/hc/en/article?id=zm_kb\&sysparm_article=KB0081099).
{% endhint %}

Toevoegen van de tool:

1. Maak een nieuwe Virtual Agent of wijzig een bestaande.
2. Maak of wijzig een **vaardigheid**.
3. In de pers op de **/ (schuine streep)** -toets om de **menu voor variabelen, tools en vaardigheden**.
4. Selecteer **Hulpmiddel**, en scrol vervolgens omlaag om de **Marketplace-vermelding voor PCI Pal**.
5. Selecteer de **PCI\_Pal\_Create\_a\_Betaling\_Link** tool uit het menu.

<div data-with-frame="true"><img src="https://3901650588-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. Geef de tool een naam en beschrijving.
7. Configureer de **Parameters en antwoorden** informatie.

U kunt de informatietabellen in de volgende sectie gebruiken om de tool te configureren.

**Parameters**

Parameters dienen als invoer voor de PCI Pal-tool om een Betaling-sessie te genereren. Sommige van deze parameters zijn verplicht, terwijl andere Optioneel zijn. Net als bij andere tools die u mogelijk gebruikt, kunnen deze invoergegevens een van de volgende zijn:

* Statische waarden
* Gekoppeld aan variabelen
* Verzameld via LLM

De lijst met velden die Beschikbaar zijn in de volgende tabellen vertegenwoordigt alle mogelijke informatie die nodig kan zijn om Betaling mogelijk te maken. De klant moet samenwerken met PCI Pal en hun Betaling Services Provider (PSP) om te bepalen welke velden vereist zijn voor hun unieke scenario.

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

Als u de klant vraagt een Betaling te doen, kunt u ervan uitgaan dat u al hebt vastgesteld wie er belt, de status van hun bestelling hebt gecontroleerd, enzovoort. Gebruik aanvullende vaardigheden en tools om deze informatie op te slaan met behulp van globale variabelen als referentie binnen de PCI Pal-tool.
{% endhint %}

| Variabelenaam  | Vereiste  | Beschrijving                                                                                                                                                                                                                                          |
| -------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `flowId`       | Verplicht | <p>De unieke <code>flowId</code> voor uw PCI Pal-betalingsworkflow. Dit nummer staat in uw PCI Pal-installatiehandleiding.</p><ul><li><strong>Let op:</strong> U moet samen met PCI Pal de juiste ID voor het betalingstraject vaststellen.</li></ul> |
| `reference`    | Verplicht | Een veld om een aangepaste referentie toe te passen op de Betaling. Dit wordt opgenomen in alle webhooks voor Betaling in overeenstemming met PCI Pal.                                                                                                |
| `amount`\*\*   | Verplicht | <p>Het bedrag dat moet worden betaald. Geef dit op in het formaat dat is gespecificeerd in uw PCI Pal-configuratiegids.</p><ul><li><strong>Let op:</strong> Je hoeft alleen een waarde op te geven. Een valuta is niet nodig.</li></ul>               |
| `valuta`       | Optioneel | De Valuta in ISO 4217-indeling (USD/GBP). Dit is een Optioneel veld. Raadpleeg uw PCI Pal-configuratiegids voor specifieke details of vereisten.                                                                                                      |
| `firstName`    | Verplicht | De voornaam van de klant. U kunt worden gevraagd om zowel de voor- als achternaam van de kaarthouder in één veld te verzenden. Raadpleeg uw PCI Pal-configuratiegids.                                                                                 |
| `lastName`     | Verplicht | De achternaam van de klant. U kunt worden gevraagd om zowel de voor- als achternaam van de kaarthouder in één veld te verzenden. Raadpleeg uw PCI Pal-configuratiegids.                                                                               |
| `addressLine1` | Verplicht | De eerste regel van het adres van de klant. Geef dit op in het formaat dat is gespecificeerd in uw PCI Pal-configuratiegids.                                                                                                                          |
| `addressLine2` | Optioneel | De tweede regel van het adres van de klant. Verstrek deze in de notatie die is gespecificeerd in uw PCI Pal-installatiegids.                                                                                                                          |
| `city`         | Verplicht | Adresgegevens van de klant. Verstrek deze in de notatie die is gespecificeerd in uw PCI Pal-installatiegids.                                                                                                                                          |
| `state`        | Optioneel | Adresgegevens van de klant. Verstrek deze in de notatie die is gespecificeerd in uw PCI Pal-installatiegids.                                                                                                                                          |
| `zipcode`      | Verplicht | Adresgegevens van de klant. Verstrek deze in de notatie die is gespecificeerd in uw PCI Pal-installatiegids.                                                                                                                                          |
| `country`      | Optioneel | Adresgegevens van de klant. Verstrek deze in de notatie die is gespecificeerd in uw PCI Pal-installatiegids.                                                                                                                                          |
| `E-mail`       | Optioneel | Het e-mailadres van de klant. Optioneel. Alleen verstrekken indien vereist in uw PCI Pal-installatiegids.                                                                                                                                             |
| `phoneNumber`  | Optioneel | Het telefoonnummer van de klant. Optioneel. Alleen verstrekken indien vereist in uw PCI Pal-installatiegids. De gids specificeert ook de vereiste notatie voor het nummer.                                                                            |
| `customData1`  | Optioneel | Een Optioneel, aanvullend gegevensveld. Alle vereiste gegevens worden gespecificeerd in de PCI Pal-installatiehandleiding naast het vereiste formaat.                                                                                                 |
| `customData2`  | Optioneel | Een Optioneel, aanvullend gegevensveld. Alle vereiste gegevens worden gespecificeerd in de PCI Pal-installatiehandleiding naast het vereiste formaat.                                                                                                 |
| `customData3`  | Optioneel | Een Optioneel, aanvullend gegevensveld. Alle vereiste gegevens worden gespecificeerd in de PCI Pal-installatiehandleiding naast het vereiste formaat.                                                                                                 |
| `customData4`  | Optioneel | Een Optioneel, aanvullend gegevensveld. Alle vereiste gegevens worden gespecificeerd in de PCI Pal-installatiehandleiding naast het vereiste formaat.                                                                                                 |
| `customData5`  | Optioneel | Een Optioneel, aanvullend gegevensveld. Alle vereiste gegevens worden gespecificeerd in de PCI Pal-installatiehandleiding naast het vereiste formaat.                                                                                                 |

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

De `additionalField1`, `additionalField2` en `additionalField3` velden zijn tijdelijke aanduidingen voor aangepaste waarden. De PSP van een klant kan bijvoorbeeld specifieke vluchtinformatie vereisen, zoals de luchthaven van vertrek, de luchthaven van bestemming en het vluchtnummer. Met deze velden kunt u dergelijke specifieke informatie vastleggen.
{% endhint %}

{% hint style="warning" %}
**\*\*Aanvullende richtlijnen voor het `amount`** **veld**:

Het `amount` veld **moet** worden gevuld met het bedrag dat de klant betaalt.

Er zijn **twee elementen** van een betalingsbedrag waarmee rekening moet worden gehouden: **Valuta** en **Waarde**.

| Valuta                                                                                                                                          | Waarde                                                                                                                         |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <ul><li>De valuta is gebaseerd op ISO4217-indeling (GBP, USD, enz.) en wordt door PCI Pal geconfigureerd binnen de Betaling-workflow.</li></ul> | <ul><li>Het Betaling-bedrag en de indeling zijn belangrijk, en de indeling wordt ingesteld door de PSP van de klant.</li></ul> |
| <ul><li><strong>U hoeft de valuta niet op te nemen</strong>.</li></ul>                                                                          | <ul><li><strong>De waarde moet de juiste indeling hebben</strong>.</li></ul>                                                   |

De PSP kan vereisen dat het bedrag wordt gedefinieerd met behulp van de kleinst mogelijke meeteenheid, zoals pence, centen en zo voort. Dit helpt de mogelijkheid van decimale rekenfouten te voorkomen. Bijvoorbeeld:

* 100 = 100 pence = £1
* 1638 = 1638 cent = $16,38

**U moet met PCI Pal en uw PSP bepalen hoe het betalingsbedrag tijdens de betalingsworkflow wordt weergegeven**.
{% endhint %}

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

Het vastleggen van het telefoonnummer en E-mailadres van de klant vergemakkelijkt de levering van de Betaling-link. Combineer de PCI Pal-skill met de sms- en/of E-mailtool om de link naar de klant te sturen (vooral handig voor use cases met een spraakagent).
{% endhint %}

**Antwoorden**

| Variabelenaam        | Vereiste  | Beschrijving                                                                                                                                                                                        |
| -------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Id`                 | Optioneel | De unieke Identificatie (GUID) voor de gegenereerde Betaling-sessie. Deze wordt voornamelijk gebruikt voor logboekregistratie en om deze aan PCI Pal-ondersteuning te geven voor probleemoplossing. |
| `LinkId`             | Optioneel | Niet vereist voor de huidige implementatie, maar opgenomen voor mogelijk toekomstig gebruik.                                                                                                        |
| `DigitalSessionLink` | Verplicht | De Betaling-sessielink                                                                                                                                                                              |

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

Het veld `DigitalSessionLink` bevat de betaallink die de klant nodig heeft. Gebruik de sms- of E-mailtool om de link te versturen naar een telefoonnummer of E-mailadres dat tijdens het klantgesprek is vastgelegd.
{% endhint %}

### De Voice Agent gebruiken

Deze walkthrough leidt u door een praktische voorbeeldconfiguratie van een Betaling-workflow met een voice agent. Deze walkthrough is ook van toepassing op Zoom Virtual Agent-chatagenten.

In dit voorbeeld belt de klant om te weten waar de bestelling is, en de voice agent zegt dat de bestelling vertraging heeft opgelopen vanwege een openstaand saldo. Vervolgens biedt de agent de klant de mogelijkheid om het saldo te vereffenen via de Betaling-workflow van PCI Pal.

Voor dit voorbeeld hebt u het volgende nodig:

* Een werkende sms-configuratie in Zoom contactcenter
* Een E-mailaccount gekoppeld aan Zoom Virtual Agent
* Een bestaande kennisbankrepository

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

Het configureren van sms voor Zoom contactcenter, het koppelen van een E-mailaccount aan Zoom Virtual Agent en het opzetten van een kennisbank vallen buiten het bereik van dit document. Zie [Zoom-ondersteuning](https://support.zoom.com/hc/en) voor meer informatie.
{% endhint %}

#### Een Voice Agent maken

Voor deze use case maakt u een eenvoudige voice agent:

1. Meld u aan bij het Zoom Beheercentrum.
2. Selecteer aan de linkerkant van het Scherm **Productconfiguratie > AI Studio > Virtuele agenten**.
3. Klik op de **Virtuele agent Toevoegen** vervolgkeuzeknop en Selecteer **Op instructies gebaseerd**.
4. Klik op **Vanaf nul beginnen** in het Pop-upvenster dat verschijnt.
5. Maak een nieuwe **Op instructies gebaseerd** spraakagent, beginnend met een lege sjabloon.
6. Voer de volgende gegevens in het **Agent maken** workflowvenster in:
   1. Klik op de **Chatbericht** modaliteit om deze te deselecteren. In dit voorbeeld is alleen de spraakmodaliteit vereist.
   2. In de **Agentnaam** tekstvak, Invoeren: "Bestelagent." Klik op **Volgende**.
   3. **Instructies**: "Je bent een vriendelijke agent die Klanten helpt met hun bestellingen en betalingen. API's presenteren openstaande saldi in pence. Wanneer je deze aan een klant gaat presenteren, moet je ze voorlezen in ponden en pence (bijvoorbeeld: 1000 is £10), maar de waarde die de API retourneert niet wijzigen." Klik op **Volgende**.
   4. Selecteer de primaire stem en Taal voor je agent uit de opties die Beschikbaar zijn. Klik op **Volgende**.
   5. Selecteer een kennisbank uit de lijst **Bestaande bron gebruiken** . Klik op **Volgende**.
   6. (Optioneel) Kies een van de beschikbare Skills uit de laatste stap van de workflow.
   7. Klik op **Maken**.

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

Een productieagent zou uitgebreide begeleiding en randvoorwaarden bevatten. Voor dit voorbeeld ligt de focus op het creëren van het Betalingstraject. Deze voorbeeldagent bevat geen aanvullende randvoorwaarden.
{% endhint %}

#### Globale variabelen configureren

Je hebt verschillende variabelen nodig voor dit gebruiksscenario. Configureer ze als volgt:

1. Meld u aan bij het Zoom Beheercentrum.
2. Navigeer naar **AI Studio → Virtual Agents**.
3. Klik op het **Voorkeuren** tabblad bovenaan het scherm.
4. Klik op het **Variabelen** pictogram.
5. Maak een aangepaste Groep voor variabelen door op de **+Aangepaste Groep Toevoegen** link onderaan de kolom te klikken.
6. Geef de aangepaste Groep voor variabelen de naam "**Betaling**."
7. Klik op **Toevoegen**.

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

8. Klik op de aangepaste Groep die je zojuist hebt gemaakt en klik vervolgens op **+Variabele Toevoegen** in de rechterbovenhoek van het Scherm.
9. Maak de volgende variabelen aan:

| Variabelenaam | Type   | Waarde         |
| ------------- | ------ | -------------- |
| E-mail        | String | Ongedefinieerd |
| phone         | String | Ongedefinieerd |
| link          | String | Ongedefinieerd |

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

#### De bestaande voiceagent bewerken

Nadat je de variabelen hebt geconfigureerd, moet je teruggaan naar de voiceagent en skills maken om het opzoeken van bestellingen en veilige betalingen mogelijk te maken.

1. Ga naar **AI Studio → Virtual Agents → Agents**.
2. Wijzig de voiceagent die je eerder hebt gemaakt.
3. Scrol omlaag naar de **Vaardigheden** sectie van de configuratie van de spraakagent.
4. Ga verder naar de volgende secties om twee skills te maken.

**Een skill voor orderupdates maken**

Maak vervolgens een skill om klanten informatie te geven over hun recente bestellingen. Je gebruikt statische JavaScript-code om een API-aanroep te simuleren en fictieve bestelgegevens terug te geven.

1. Klik op **+Vaardigheid maken** en maak een **vaardigheid op basis van instructies**.
2. Voer de volgende gegevens in:
   1. Naam: Bestelgegevens ophalen
   2. Trigger: Gebruik deze skill om informatie over een recente bestelling op te halen
3. Druk in het venster Instructies op de **/ (schuine streep)** -toets.
4. Selecteer **Tool** en klik op **Een nieuwe tool maken**.
5. Klik op **Aangepast script**.
6. Voer de volgende gegevens in:
   1. Naam: `get_order_details`
   2. Beschrijving: Om informatie over bestellingen op te halen
   3. JavaScript: Gebruik het onderstaande codeblok:

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

Deze code simuleert een API bellen en geeft details over een fictieve bestelling met een openstaand saldo. De informatie in dit antwoord wordt ingevoerd in de parameters die zijn geconfigureerd als 'Verzamelen via LLM' wanneer je de PCI-Betalingstool maakt.

7. Klik op **Maken**.
8. Voltooi de instructies van de skill met behulp van de volgende tekst:

```plaintext
1. Vraag de klant naar het bestelnummer
2. Haal de bestelgegevens op
3. Geef de klant informatie
```

9. Je skillconfiguratie moet eruitzien zoals in de volgende afbeelding:

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

10. Klik op **Toevoegen**.

**Een Betaling-skill maken**

Volgende maak je een skill die de vooraf gebouwde PCI Pal Marketplace-tool gebruikt om een beveiligde Betalinglink te genereren. Hiermee wordt de link naar de klant gestuurd, die vervolgens Betalinggegevens kan verstrekken op de beveiligde Betalingpagina.

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

Wanneer de skill Bestellingsupdate een openstaand saldo vaststelt, kan de virtuele agent deze skill automatisch aanroepen.
{% endhint %}

1. Klik op **+Vaardigheid maken** en selecteer de optie om een **op instructies gebaseerde vaardigheid**.
2. Voer de volgende gegevens in:
   1. Naam: Betaling aannemen
   2. Trigger: Wanneer de klant moet betalen voor goederen of diensten
3. Druk in het venster Instructies op de **/ (schuine streep)** -toets.
4. Selecteer **tool**, en scrol vervolgens omlaag om de PCI Pal-vermelding in de Marketplace te vinden.
5. Selecteer **PCI Pal - Een betalingslink maken** hulpmiddel in het menu.
6. Voer de volgende gegevens in:
   1. Naam: `create_Betaling_link`
7. Scrol omlaag naar de **Parameters** sectie.
8. Verwijder alle parameters die Optioneel zijn, behalve `addressLine2`, `state`, `E-mail`, en `phoneNumber`, en Configureer vervolgens de parameters als volgt:

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

Alle velden die niet in de volgende tabel staan, moeten uit de tool worden verwijderd. Niet-vermelde velden zijn niet vereist voor deze toepassing.
{% endhint %}

<table><thead><tr><th width="142">Naam</th><th>Waardebron</th><th width="104">Waarde instellen</th><th width="90">Waarde</th><th>Toewijzen aan variabele</th></tr></thead><tbody><tr><td><code>flowId</code></td><td>Handmatig instellen</td><td>Statische waarde</td><td>2213</td><td>N.v.t.</td></tr><tr><td><code>reference</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td>N.v.t.</td></tr><tr><td><code>amount</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td>N.v.t.</td></tr><tr><td><code>firstName</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td>N.v.t.</td></tr><tr><td><code>lastName</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td>N.v.t.</td></tr><tr><td><code>addressLine1</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td>N.v.t.</td></tr><tr><td><code>addressLine2</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td>N.v.t.</td></tr><tr><td><code>city</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td>N.v.t.</td></tr><tr><td><code>state</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td>N.v.t.</td></tr><tr><td><code>zipcode</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td>N.v.t.</td></tr><tr><td><code>E-mail</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td><code>global_custom.Betaling.E-mail</code></td></tr><tr><td><code>phoneNumber</code></td><td>Verzameld via LLM</td><td>N.v.t.</td><td>N.v.t.</td><td><code>global_custom.Betaling.phone</code></td></tr></tbody></table>

9. Scroll omlaag naar het onderdeel **Respons** .
10. Verwijder alle parameters behalve `DigitalSessionLink` die je vervolgens als volgt moet configureren:
    1. Beschrijving: De unieke Betalinglink
    2. Toewijzen aan variabele: `global_custom.Betaling.link`
11. Klik **Opslaan en Toevoegen**.
12. Druk in het venster Instructies op de **/ (schuine streep)** sleutel opnieuw.
13. Voeg de **sms** tool en Configureer als volgt:
    1. Telefoonnummer afzender: Selecteer een geschikt nummer in de vervolgkeuzelijst.
    2. Nummer ontvanger: Van variabele
    3. Variabele: `global_custom.Betaling.phone`
    4. Inhoud: Gebruik deze beveiligde Betalinglink
       1. In de pers op de **/ (schuine streep)** toets aan het einde van deze tekenreeks en zoek de `global_custom.Betaling.link` variabele.
14. De sms-tool moet er ongeveer uitzien zoals in de volgende afbeelding:

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

15. Klik **Opslaan en Toevoegen**.
16. Druk in het venster Instructies op de **/ (schuine streep)** sleutel opnieuw.
17. Toevoegen van de **E-mail** tool en Configureer deze als volgt:
    1. E-mailaccount afzender: Selecteer een van je gekoppelde E-mailaccounts.
    2. E-mailadres van de ontvanger: `global_custom.Betaling.E-mail`
    3. e-mailsjabloon:
       1. Onderwerp: Je beveiligde Betalinglink
       2. Tekst: Gebruik deze beveiligde Betalinglink
          1. In de pers op de **/ (schuine streep)** toets aan het einde van deze tekenreeks en zoek de `global_custom.Betaling.link` variabele.
18. De E-mailtool moet eruitzien zoals in de volgende afbeelding:

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

19. Klik **Opslaan en Toevoegen**.
20. Voltooi de instructies van de skill met behulp van de volgende tekst:

```plaintext
1. Vraag de klant of deze de Betalingslink liever via E-mail of sms wil ontvangen.
2. Bevestig het bedrag dat de klant zal betalen.
3. Als de klant om sms heeft gevraagd, vraag dan naar het telefoonnummer. Vraag anders naar het E-mailadres.
4. Stuur, afhankelijk van de voorkeur, een sms of E-mail. Niet allebei. 
```

21. Je skillconfiguratie moet eruitzien zoals in de volgende afbeelding:

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

22. Klik op **Toevoegen**.

### De spraakagent testen

Je bent nu klaar om de spraakagent te testen. Klik in het voorbeeldvenster op de knop **Test starten** om een gesprek met de spraakagent te beginnen.

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

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

U kunt elk willekeurig nummer als ordernummer gebruiken. Telkens wordt dezelfde bestelling teruggegeven. Het ordernummer dat u Invoeren, wordt door de PCI Pal Betalingtool gebruikt als Betalingsreferentie.
{% endhint %}

Hieronder staat ter referentie een voorbeeld van een dialoog tussen agent en klant:

> **Agent:** Hallo! Bedankt voor het bellen. Ik ben je virtuele assistent. Waarmee kan ik je vandaag helpen?
>
> **Klant:** Hallo, mijn bestelling is nog niet aangekomen. Kunt u dat voor me nakijken?
>
> **Medewerker:** Natuurlijk, ik help u graag. Kunt u uw bestelnummer doorgeven?
>
> **Klant:** Ja, dat is 1234.
>
> **Medewerker:** Dank u wel. Ik ga het voor u nakijken.
>
> **Medewerker:** Uw bestelling is vertraagd omdat er nog een bedrag van honderdvijfentwintig pond en zevenenvijftig pence openstaat.
>
> **Medewerker:** Wilt u dit nu betalen om uw bestelling vrij te geven?
>
> **Klant:** Ja, graag.
>
> **Medewerker:** Dank u. Ik help u dit in orde te maken.
>
> **Medewerker:** Wilt u de betalingslink per E-mail of sms ontvangen?
>
> **Klant:** E-mail, alstublieft.
>
> **Medewerker:** Kunt u uw E-mailadres geven, zodat ik u de betalingslink kan sturen?
>
> **Klant:** Ja, het is <example@example-email.com>.
>
> **Agent:** Bedankt. Wilt u bevestigen dat u honderd vijfentwintig pond en zevenenvijftig pence betaalt? Klopt dat?
>
> **Klant:** Ja.
>
> **Agent:** Bedankt voor de bevestiging. Ik heb ook uw telefoonnummer nodig om de Betaling te verwerken. Kunt u dit alstublieft doorgeven?
>
> **Klant:** Ja, het is 555-555-1234.
>
> **Medewerker:** Bedankt voor het doorgeven van uw telefoonnummer. De betalingslink wordt naar uw E-mailadres gestuurd. Controleer uw inbox en volg de link om honderd vijfentwintig pond en zevenenvijftig pence te betalen.

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

Merk op hoe de spraakagent vaststelt dat de klant een openstaand saldo heeft en automatisch overschakelt naar de Betalingsfunctie.
{% endhint %}

Om het testen af te ronden, controleert u uw test-sms of E-mailaccount en klikt u op de Betalingslink. Wanneer daarom wordt gevraagd, kunt u de volgende kaartgegevens gebruiken:

* **Kaartnummer**: 1111 2222 3333 4444
* **Vervaldatum**: Elke maand/jaar-notatie van 4 cijfers in de toekomst (bijv. 1228)
* **Beveiligingscode**: Elk getal van 3 cijfers (bijv. 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/nl/zakelijke-services/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.
