> ## 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.

# Acties

> Leer hoe u een Actie gebruikt in uw Workflow automatiseringen

<Note>
  *Workflow automatiseringen* zijn bedoeld om het werk van een agent eenvoudiger te maken door processen te automatiseren, zoals het versturen van een opvolg-sms, het transcriberen van bepaalde gesprekken of het automatisch doorsturen van transcripties naar Slack. Het type stap dat ervoor zorgt dat deze acties worden uitgevoerd, heet een **Actie** (niet te verwarren met een *Objectactie* die u binnen de Trigger selecteert).
</Note>

**Gebruikersniveau:** Admin

***

<h2 id="h_2b27478f29">
  Een Actie instellen
</h2>

In Workflow-automatisering is een **Actie**-stap de plek waar een specifieke taak automatisch wordt uitgevoerd. Zodra aan de voorwaarden vóór deze stap is voldaan, wordt de actie geactiveerd. Hier voert het systeem acties uit op basis van uw configuratie.

Een **Actie**-stap van een workflowautomatisering kunt u op elk punt na de **Trigger** aan de workflow toevoegen. U hoeft alleen de optie **`+ Actie toevoegen`** te selecteren wanneer u een nieuwe stap in de workflow instelt.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/0b872f47cd70-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=b68d6d7c7933e8ecd1c8a901fe53270b" alt="" width="1588" height="294" data-path="images/help-center/articles/5649782/0b872f47cd70-image.png" />
</Frame>

CloudTalk biedt momenteel vier typen acties:

* **[API-verzoek](#h_0267cfe306)**

* **[SMS](#h_1714226b93)**

* **[Melding naar Slack verzenden](#h_1710cb965a)**

* **Speech to Text (alleen zichtbaar wanneer de *Opname*-trigger wordt gebruikt)**

<Note>
  Elke automatiseringsworkflow heeft minimaal één actie nodig om te werken zoals verwacht. U kunt meerdere acties binnen dezelfde workflow toevoegen om uw automatisering nog efficiënter te maken.
</Note>

<h2 id="h_0267cfe306">
  API-verzoek
</h2>

<Warning>
  Wilt u alleen uw eigen systeem op de hoogte brengen wanneer er iets gebeurt in CloudTalk, zoals het einde van een gesprek of een wijziging in een contact? Gebruik dan [Webhooks](/guides/webhooks/overview). Webhooks zijn gebouwd voor betrouwbare levering van events, met ondertekende payloads, automatische nieuwe pogingen en opnieuw verzenden en herstel gedurende 30 dagen. Acties van het type API-verzoek gebruiken een apart afleverpad, dat deze mogelijkheden niet bevat.
</Warning>

Dit Actietype is geschikt voor technisch onderlegde gebruikers die meer creatieve vrijheid willen bij het ontwerpen van automatiseringen. Een API (Application Programming Interface) zorgt ervoor dat verschillende webapplicaties met elkaar kunnen communiceren. Op dit moment kunnen verzoeken worden gestuurd naar de [CloudTalk REST API](/developers) of naar andere, externe systemen die gebruikmaken van:

* Authenticatieschema's die statische, onveranderlijke headers vereisen (bijv. Basic- of Bearer-authenticatieschema's)

* Systemen met authenticatie via URL / JSON-body.

De API van CloudTalk is een voorbeeld van dat laatste type. Elke API-actie bestaat uit de volgende onderdelen:

<table>
  <tbody>
    <tr>
      <td>
        "Naam"
      </td>

      <td>
        Definitie
      </td>

      <td>
        Voorbeeldwaarde
      </td>
    </tr>

    <tr>
      <td>
        **Eindpunt**
      </td>

      <td>
        *URL van het betreffende API-eindpunt*
      </td>

      <td>
        [`https://my.crmwebsite.com/api/contacts/index`](https://my.crmwebsite.com/api/contacts/index)
      </td>
    </tr>

    <tr>
      <td>
        **Methode**
      </td>

      <td>
        *Bepaalt de actie van het API-verzoek*
      </td>

      <td>
        Geaccepteerd: `PUT`, `POST`, `PATCH`, `GET`, `DELETE`
      </td>
    </tr>

    <tr>
      <td>
        **Headers**
      </td>

      <td>
        *Metadata, vaak noodzakelijk voor authenticatie en andere doeleinden*
      </td>

      <td>
        Sleutel: `Autorisatie`\
        Waarde: `Basic x1x2x3x4x5x6x789`
      </td>
    </tr>

    <tr>
      <td>
        **Waarden**
      </td>

      <td>
        *Bepalen de body van het verzoek in de vorm van een JSON-object*
      </td>

      <td>
        Sleutel: `contactName`

        Waarde: `Johnny Snow`

        Formaat: `String`
      </td>
    </tr>
  </tbody>
</table>

Gebruik het gedeelte **Waarden** van de API-verzoekbouwer om de body van een verzoek te definiëren. Elke vermelding in het gedeelte **Waarden** bevat een *Sleutel*, *Waarde,* en *Formaat*.

In dit geval is **Sleutel** de *eigenschapsnaam* in het API-verzoek. Bijvoorbeeld:

```
contactName
```

**Waarde** kan *statisch* zijn. Bijvoorbeeld iets als:

```
Johnny Snow
```

Deze waarde kan ook een *dynamische* eigenschap zijn die de waarde doorgeeft op basis van de gegevens uit de door u gekozen Trigger. Voor een dynamische waarde kiest u een van de blauwe zinsdelen in de zijbalk **Nuttige gegevens voor uw workflow**. Zoals hieronder te zien is, wordt het veld **Waarde** gevuld met iets als:

```
#{{event.properties.contacts[0].name}}
```

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/d2fb43651165-api-ref.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=45f397722e6dc9f680d6d5fd50eaf711" alt="" width="1996" height="792" data-path="images/help-center/articles/5649782/d2fb43651165-api-ref.png" />
</Frame>

In dit voorbeeld wordt de waarde *name* opgehaald uit het contact dat aan uw Trigger is gekoppeld.

De waarde **Formaat** beschrijft een gegevenstype, zodat het doelsysteem (API) de meegestuurde gegevens correct kan interpreteren. CloudTalk ondersteunt de volgende formaten:

* **Getal** - gehele getallen (integers) of decimalen (floats met een punt als decimaalteken)

* **String** - reeks alfanumerieke tekens

* **Boolean** - evalueert naar True of False (elke niet-gedefinieerde vorm wordt standaard False)

* **Automatisch** - het type wordt automatisch gedetecteerd

<h2 id="h_1714226b93">
  SMS
</h2>

De Actie-stap SMS zorgt ervoor dat er als onderdeel van de automatisering een SMS naar het opgegeven nummer wordt verstuurd. Op de achtergrond stuurt het systeem een API-verzoek met de geconfigureerde gegevens naar het [API-eindpunt Send SMS van CloudTalk](/developers#tag/Sms/paths/~1sms~1send.json/post), waardoor de SMS wordt verzonden zonder tussenkomst van een agent.

Om de Actie SMS te configureren, moet u de volgende kenmerken instellen:

* ***Ontvanger*** - telefoonnummer in internationaal formaat waarnaar de SMS moet worden verstuurd

* ***Afzender*** - SMS-geschikt telefoonnummer in internationaal formaat waarvandaan de SMS moet worden verstuurd

* ***Tekst*** - inhoud van het bericht dat moet worden verstuurd

* ***API-sleutel*** en ***API Secret*** - API-inloggegevens die door de admin uit het CloudTalk Dashboard worden opgehaald

Omdat deze actie een verzoek naar de CloudTalk API inhoudt, gelden de standaard rate limits. Raadpleeg voor meer details onze [API-documentatie](/developers#section/API-Overview/Usage).

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/8f6e29a0f474-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=22082be676499acccf008dbd4e51109e" alt="" width="1632" height="1022" data-path="images/help-center/articles/5649782/8f6e29a0f474-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/54745a3951f9-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=e22b01ccc3974d5eb393c08aeb731faa" alt="" width="1632" height="1128" data-path="images/help-center/articles/5649782/54745a3951f9-image.png" />
</Frame>

<h4 id="h_ed9b4080e8">
  Veelvoorkomende problemen
</h4>

* Nummers in de velden **Ontvanger** en **Afzender** moeten in **internationaal formaat** staan.

* Het nummer dat als **Afzender** wordt gebruikt, moet **SMS-geschikt** zijn.

* API-inloggegevens moeten **zonder extra spaties** worden ingevoerd.

* Zorg dat er voldoende **accounttegoed** is, want SMS-automatisering brengt extra kosten met zich mee.

<h2 id="h_1710cb965a">
  Melding naar Slack verzenden
</h2>

Dit Actietype wordt vaak gebruikt voor interne meldingen, waarbij belangrijke informatie naar een Slack-kanaal van het bedrijf wordt doorgestuurd. Zorg dat u voor deze optie verbinding hebt met de juiste Slack-workspace en het juiste kanaal. Controleer daarnaast of de tokenscopes voor de workspace en het kanaal de rechten **chat:write** bevatten.

Om de actie Melding naar Slack verzenden te configureren, moeten de volgende kenmerken worden gedefinieerd:

* **Token**: een authenticatietoken dat via de interface van Slack wordt gegenereerd.

* **Channel**: het Slack-kanaal waarin berichten worden geplaatst.

* **Text**: de inhoud van het bericht.

* **Icon\_emoji**: een emoji-icoon dat het bericht weergeeft.

* **Icon\_url**: een URL voor een aangepast icoon dat het bericht weergeeft.

* **Use\_markdown**: wanneer dit op **True** staat, wordt de **text** weergegeven als opgemaakte tekst.

Net als bij API-verzoeken kan de waarde van elke parameter worden ingesteld als een statische vermelding of een dynamische waarde. Klik voor een dynamische waarde in het veld **Waarde** en selecteer vervolgens een van de blauwe zinsdelen in de zijbalk **Nuttige gegevens voor uw workflow**.

De resulterende Slack-melding ziet er ongeveer zo uit:

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/f3b072d2646e-slack-result.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=0cb4ffc97c5d425a638e6915361164ab" alt="" width="697" height="454" data-path="images/help-center/articles/5649782/f3b072d2646e-slack-result.png" />
</Frame>

<h2 id="h_8f5fef5c11">
  Speech to Text-transcriptie
</h2>

Dit Actietype wordt vaak gebruikt om gesprekken die tijdens een oproep zijn opgenomen om te zetten in geschreven tekst. Houd er rekening mee dat deze Actie alleen beschikbaar is wanneer de Trigger **Opname geüpload** is geselecteerd.

Om de actie Speech to Text te configureren, moeten de volgende kenmerken worden gedefinieerd:

* **Taal**

* **Verbeterde transcriptie**

* **Model**

[Lees meer](/nl/articles/5671571-speech-to-text-transcription) over Speech-to-Text-transcriptie voor een beter begrip van hoe deze functionaliteit werkt, wat de mogelijkheden zijn en welke kosten eraan verbonden zijn.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/f5c7880d5efa-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=854c2d7540c6b4020503a28f755307c0" alt="" width="1458" height="1310" data-path="images/help-center/articles/5649782/f5c7880d5efa-image.png" />
</Frame>

<h2 id="h_b4bcdfa5d9">
  Output van eerdere Actie-nodes hergebruiken
</h2>

U kunt in volgende stappen van uw workflow dynamisch verwijzen naar de respons van een eerdere Actie-stap van het type API-verzoek.

<h3 id="h_8f05ed7c5f">
  Hoe het werkt
</h3>

Om toegang te krijgen tot gegevens die door een eerdere Actie van het type API-verzoek zijn geretourneerd, moet u het **exacte formaat** gebruiken:

```
#{{ actionData.[actionIdentifier].message.[fieldName] }}
```

* `[actionIdentifier]` is de unieke identificatie van de Actie-node, die bij het toevoegen wordt toegewezen (bijv. een door het systeem gegenereerde identificatie zoals `28547585`, of een aangepaste naam zoals `SendToCRM`)

* `message` staat voor de body van de respons, die een JSON-object hoort te zijn

* `[fieldName]` is een willekeurig veld binnen dat JSON-object

<Warning>
  Het voorvoegsel `.message.` is **verplicht** wanneer u naar responsgegevens verwijst. Als u het weglaat of een andere structuur gebruikt, werkt de verwijzing niet.
</Warning>

*Voorbeeld*

Stel dat we een Actie-node van het type API-verzoek hebben met de identificatie `CreateLead`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/9ea2ff3e154d-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=ed7fd12fe9cea1916099cea8ffe5ac95" alt="" width="1644" height="298" data-path="images/help-center/articles/5649782/9ea2ff3e154d-image.png" />
</Frame>

De API-verzoek-actie `CreateLead` geeft deze respons terug:

```json theme={"system"}
{
  "lead_id": "abc123",
  "status": "created"
}
```

Om in een andere Actie naar `lead_id` te verwijzen, gebruikt u deze verwijzing:

```
#{{ actionData.CreateLead.message.lead_id }}
```

***

*Hulp nodig of een vraag?* Neem gerust contact met ons op via ons [Supportportaal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we staan voor u klaar.


## Related topics

- [Salesforce-acties](/nl/articles/9394264-salesforce-actions.md)
- [Scenario's & Guardrails voor VoiceAgents](/nl/articles/14073408-voiceagent-scenarios-guardrails.md)
- [Workflow automatiseringen configureren](/nl/articles/5450779-configuring-workflow-automations.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.