> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Een VoiceAgent-oproep starten vanuit Salesforce
> Start CloudTalk VoiceAgent-oproepen rechtstreeks vanuit Salesforce met Flow Builder en een Apex HTTP-callout
U kunt vanuit Salesforce automatisch een CloudTalk VoiceAgent-oproep starten met Flow Builder en een HTTP Callout, ondersteund door een Apex-klasse. In deze handleiding leest u hoe u de verbinding instelt, de oproepactie toevoegt en controleert of de oproep is gestart.
**Gebruikersniveau:** Admin
***
Voordat u begint
U hebt het volgende nodig:
* Een reeds aangemaakte CloudTalk VoiceAgent (noteer de VoiceAgent-ID)
* [CloudTalk API-inloggegevens](/nl/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) (API-sleutel en Secret)
* Salesforce Enterprise edition of hoger (Flow Builder met HTTP Callout)
* Een telefoonveld op uw Contact- of Lead-records, in `E.164`-notatie (bijvoorbeeld `+14155550100`)
De integratie instellen
De Named Credential aanmaken
Maak eerst een External Credential aan om uw CloudTalk API-sleutel veilig op te slaan:
1. Ga naar **Setup > Security > Named Credentials > External Credentials**.
2. Klik op **New External Credential**:
* **Label:** CloudTalk API
* **Name:** CloudTalk\_API
* **Authentication Protocol:** Basic
3. Klik op **Save** en klik vervolgens onder **Principals** op **New**:
* Kies een naam en stel **Identity Type** in op **Named Principal**.
* Voer uw CloudTalk **API Key ID** in als gebruikersnaam en **API Secret** als wachtwoord.
* Klik op **Save**.
Maak vervolgens de Named Credential aan die naar CloudTalk verwijst:
1. Ga naar **Setup > Security > Named Credentials > Named Credentials**.
2. Klik op **New Named Credential**:
* **Label:** CloudTalk
* **Name:** CloudTalk
* **URL:** `https://api.cloudtalk.io`
* **External Credential:** CloudTalk API
* Schakel onder **Callout Options** de opties **Generate Authorization Header** en **Allow Formulas in HTTP Body** in.
3. Klik op **Save**.
Geef uzelf tot slot toegang tot de credential:
1. Ga naar **Setup > Permission Sets**, open (of maak) een permission set die aan u is toegewezen, ga vervolgens naar **External Credential Principal Access > Edit**, voeg uw `CloudTalk_API`-principal toe en klik op **Save**.
De Apex-klasse aanmaken
1. Ga naar **Setup > Apex Classes > New**.
2. Plak de onderstaande code, vervang `YOUR_VOICE_AGENT_ID` op regel 3 door uw VoiceAgent-ID en klik op **Save**.
```
public with sharing class CloudTalkVoiceAgent {
private static final String VOICE_AGENT_ID = 'YOUR_VOICE_AGENT_ID';
@InvocableMethod(label='Start CloudTalk Voice Agent Call' description='Triggers a CloudTalk voice agent call')
public static void invoke(List requests) {
for (Request r : requests) {
startCall(r.callNumber);
}
}
@future(callout=true)
public static void startCall(String callNumber) {
HttpRequest req = new HttpRequest();
req.setEndpoint('callout:CloudTalk/v1/voice-agent/calls');
req.setMethod('POST');
req.setHeader('Content-Type', 'application/json');
req.setBody(JSON.serialize(new Map{
'call_number' => callNumber,
'voice_agent_id' => VOICE_AGENT_ID
}));
HttpResponse res = new Http().send(req);
System.debug('CloudTalk status: ' + res.getStatusCode());
}
public class Request {
@InvocableVariable(label='Call Number' required=true)
public String callNumber;
}
}
```
De Flow bouwen
1. Ga naar **Setup > Process Automation > Flows > New Flow**.
2. Selecteer **Record-Triggered Flow**.
3. Configureer de trigger (Object: Contact of Lead; When: een record wordt aangemaakt of een veld verandert).
4. Voeg een voorwaarde toe om records te filteren, bijvoorbeeld alleen wanneer het telefoonveld niet leeg is.
5. Klik op **+ > Action** en zoek naar "Start CloudTalk Voice Agent Call".
6. Stel de invoerwaarde van **Call Number** in op `{!$Record.Phone}`.
7. Klik op **Save** en **Activate** om de Flow te activeren.
`call_number` en `voice_agent_id` zijn de enige verplichte velden. Optioneel kunt u `call_properties` toevoegen, zoals systeempromptvariabelen (gegevens die de VoiceAgent tijdens de oproep gebruikt) en uitvoervariabelen (gegevens die na de oproep naar uw endpoint worden teruggestuurd), afhankelijk van uw VoiceAgent-configuratie. [Lees wat u kunt opnemen](/nl/articles/11401649-voiceagents-for-outbound-calls).
Testen en controleren
1. Maak een record aan of werk een record bij dat aan uw triggervoorwaarden voldoet.
2. Controleer **Setup > Debug Logs** of de details van de Flow-interview op de uitvoering.
3. Controleer in CloudTalk of de VoiceAgent-oproep is gestart.
**Klaar!** 🚀 Uw Salesforce Flow start nu automatisch een CloudTalk VoiceAgent-oproep zodra een record aan de door u gekozen voorwaarden voldoet.
Problemen oplossen
* **Unauthorized callout:** zorg dat `api.cloudtalk.io` is toegevoegd in Remote Site Settings.
* **401 Unauthorized:** controleer de inloggegevens die in de External Credential-principal zijn opgeslagen.
* **400 Bad Request:** controleer of het telefoonnummer in E.164-notatie staat (bijvoorbeeld `+14155550100`).
* **Flow wordt niet getriggerd:** controleer of het record aan alle toegangsvoorwaarden voldoet en of de Flow actief is.
***
Hulp nodig of hebt u een vraag? Neem contact met ons op via ons [supportportaal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884). Wij staan voor u klaar.
## Related topics
- [Een VoiceAgent-oproep starten vanuit Pipedrive](/nl/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)
- [Een VoiceAgent-oproep starten vanuit Zendesk](/nl/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)
- [Een VoiceAgent-oproep starten vanuit Zapier](/nl/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.