Skip to main content
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).
Gebruikersniveau: Admin

Een Actie instellen

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.
CloudTalk biedt momenteel vier typen acties:
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.

API-verzoek

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. 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.
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 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:
“Naam”DefinitieVoorbeeldwaarde
EindpuntURL van het betreffende API-eindpunthttps://my.crmwebsite.com/api/contacts/index
MethodeBepaalt de actie van het API-verzoekGeaccepteerd: PUT, POST, PATCH, GET, DELETE
HeadersMetadata, vaak noodzakelijk voor authenticatie en andere doeleindenSleutel: Autorisatie
Waarde: Basic x1x2x3x4x5x6x789
WaardenBepalen de body van het verzoek in de vorm van een JSON-objectSleutel: contactNameWaarde: Johnny SnowFormaat: String
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:
Waarde kan statisch zijn. Bijvoorbeeld iets als:
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:
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

SMS

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

Veelvoorkomende problemen

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

Melding naar Slack verzenden

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:

Speech to Text-transcriptie

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 over Speech-to-Text-transcriptie voor een beter begrip van hoe deze functionaliteit werkt, wat de mogelijkheden zijn en welke kosten eraan verbonden zijn.

Output van eerdere Actie-nodes hergebruiken

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

Hoe het werkt

Om toegang te krijgen tot gegevens die door een eerdere Actie van het type API-verzoek zijn geretourneerd, moet u het exacte formaat gebruiken:
  • [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
Het voorvoegsel .message. is verplicht wanneer u naar responsgegevens verwijst. Als u het weglaat of een andere structuur gebruikt, werkt de verwijzing niet.
Voorbeeld Stel dat we een Actie-node van het type API-verzoek hebben met de identificatie CreateLead
De API-verzoek-actie CreateLead geeft deze respons terug:
Om in een andere Actie naar lead_id te verwijzen, gebruikt u deze verwijzing:

Hulp nodig of een vraag? Neem gerust contact met ons op via ons Supportportaal — we staan voor u klaar.