Je kunt alle schermafbeeldingen vergroten door erop te klikken. De afbeeldingen tonen zowel de node zelf als het bijbehorende instellingenmenu.
API request
Gebruik deze node om via API-verzoeken gegevens uit te wisselen met externe systemen. Gebruik GET, POST, PUT of DELETE als methode. Je kunt ook headers en een body toevoegen. Sla het resultaat van het verzoek op in een variabele om het later in het gesprek te gebruiken.
In plaats van een body kun je ook een bestand naar het externe systeem sturen, bijvoorbeeld een bestand dat de contactpersoon eerder via de node “Capture media” heeft gestuurd (zie hieronder). Klik hiervoor op “Add file”.
Een verzoek verzendt óf een body óf een bestand, nooit allebei: het bestand vervangt de body. Als “Add file” niet beschikbaar is, heeft de node al een body. Verwijder eerst de body en voeg daarna het bestand toe.
Kies onder “File upload type” hoe het bestand wordt overgedragen:
- Form data with file: Kies deze optie wanneer het externe systeem een bestandsupload verwacht zoals die van een webformulier. Het bestand wordt als één veld van het formulier verzonden. Onder “Field name” geef je dat veld een naam. Als je geen naam invoert, heet het veld “file”.
- Raw file content: Kies deze optie wanneer het externe systeem het bestand zelf als body van het verzoek verwacht. Het bestandstype wordt meegestuurd.
Voer onder “File” de link naar een extern bestand in, of klik in het veld op “Insert variable” en selecteer de variabele waarin de node “Capture media” het bestand heeft opgeslagen. Dit is dezelfde variabelenkiezer als in de andere velden van de workflow. Als het bestand tijdens de uitvoering van de workflow niet kan worden opgehaald, bijvoorbeeld omdat de variabele leeg is, wordt het verzoek niet verzonden en volgt de workflow de uitgang “If request failed”.
Het gedeelte “Body” van de node op het workflowcanvas laat vervolgens zien wat wordt verzonden: “JSON Body”, “Form data file” of “Raw file”.
Capture carousel
Gebruik deze node als je de contactpersoon wilt laten kiezen uit een vooraf bepaald aantal opties met afbeelding en beschrijving en de keuze tijdelijk in een variabele wilt opslaan voor later gebruik in het gesprek. Gebruik een terugvaltekst voor het geval de opties niet kunnen worden weergegeven.
In ons voorbeeld wordt de contactpersoon gevraagd uit drie opties te kiezen. De keuze wordt tijdelijk opgeslagen in de variabele “option”. Als de knoppen niet kunnen worden weergegeven, wordt de terugvaltekst getoond.
Capture regex
Gebruik deze node als je de invoer van de klant wilt controleren op een specifiek, vooraf bepaald formaat. Je vindt enkele voorbeelden door het volgende onderdeel uit te klappen:
Regexvoorbeelden:
Capture buttons
Gebruik deze node als je de contactpersoon wilt laten kiezen uit een vooraf bepaald aantal opties en de keuze tijdelijk in een variabele wilt opslaan voor later gebruik in het gesprek. Gebruik een terugvaltekst voor het geval de knoppen niet kunnen worden weergegeven.
In ons voorbeeld wordt de contactpersoon gevraagd uit drie opties te kiezen. De keuze wordt tijdelijk opgeslagen in de variabele “option”. Als de knoppen niet kunnen worden weergegeven, wordt de terugvaltekst getoond.
Capture email
Gebruik deze node als je het e-mailadres van de contactpersoon wilt opvragen en tijdelijk in een variabele wilt opslaan voor later gebruik in het gesprek. Bepaal of je wilt controleren of de variabele al gegevens bevat en of de contactpersoon de invoer mag overslaan.
In ons voorbeeld wordt de contactpersoon gevraagd een e-mailadres in te voeren. De invoer wordt tijdelijk opgeslagen in de variabele “email”. Het systeem controleert of de variabele al bestaat en is ingevuld in de contactvelden. De contactpersoon kan de invoer niet overslaan.
Capture media
Gebruik deze node als je wilt dat de contactpersoon binnen een workflow een document verstuurt. Kies het documenttype (Image, Video, Audio, Document of een willekeurig type).
In ons voorbeeld wordt de contactpersoon gevraagd een document van het type Image aan te leveren.
Gebruik deze node als je wilt dat de contactpersoon binnen een workflow een document verstuurt. Kies het documenttype (Image, Video, Audio, Document of een willekeurig type).
Wil je het bestand later in de workflow gebruiken, voer dan onder “Variable” een naam in, bijvoorbeeld “photo”. De node slaat vervolgens een link naar het ontvangen bestand op in die variabele. Dit is optioneel.
Je kunt de variabele vervolgens in twee nodes gebruiken. In beide velden voeg je deze toe via “Insert variable”, waar je de variabele vindt onder “This Workflow”:
- Message: Klik op “Add media” en voeg de variabele toe aan het veld “URL” om het bestand opnieuw naar de contactpersoon te sturen. De node “Message” wordt beschreven onder [Algemene nodes](https://docs.lime-connect.com/general-nodes-2c482b4dcc478116a022c5e7f0dda78e).
- API request: Voeg de variabele toe onder “File” om het bestand naar een extern systeem te sturen (zie het gedeelte “API request” hierboven).
In ons voorbeeld wordt de contactpersoon gevraagd een document van het type Image aan te leveren.
De afbeelding wordt opgeslagen in de variabele “photo”, zodat deze later in de workflow opnieuw kan worden verzonden of doorgegeven.
Capture text
Gebruik deze node als je willekeurige tekst van de contactpersoon wilt opvragen en tijdelijk in een variabele wilt opslaan voor later gebruik in het gesprek. Bepaal of je wilt controleren of de variabele al gegevens bevat en of de contactpersoon de invoer mag overslaan.
In ons voorbeeld wordt de contactpersoon gevraagd de naam van het huisdier in te voeren. De invoer wordt tijdelijk opgeslagen in de variabele “pet-name”. Het systeem controleert of de variabele al bestaat en is ingevuld in de aangepaste contactvelden. De contactpersoon kan de invoer overslaan.
Capture text, Capture email, Capture regex en Capture media gebruiken dezelfde instelling voor overslaan. Schakel “Optional” in om contactpersonen de stap te laten overslaan. Voer onder “Skip button label” de tekst van de knop in, bijvoorbeeld “Skip”. Het label mag maximaal 20 tekens bevatten en “Skip” wordt ingevuld wanneer je “Optional” inschakelt.
De contactpersoon ziet de knop vervolgens onder je bericht en slaat de stap over door erop te klikken. De workflow volgt de uitgang “When the input is skipped”. Als je “Skip button label” leeg laat, wordt er geen knop getoond en kunnen contactpersonen de stap alleen overslaan door een trefwoord voor overslaan te typen, als je workflow zulke trefwoorden heeft.
De knop wordt getoond in Website Messenger, WhatsApp en Facebook Messenger. In alle andere kanalen ziet de contactpersoon alleen je bericht en kan de stap uitsluitend worden overgeslagen door een trefwoord voor overslaan te typen. Dat werkt ook wanneer de knop wordt getoond. Alle andere tekst, waaronder “1”, wordt behandeld als antwoord op de vraag.
WhatsApp list
Gebruik deze node om je contactpersonen in WhatsApp-kanalen een keuze te laten maken uit een vooraf bepaalde lijst met opties. De lijst kan maximaal 10 opties tonen.
WhatsApp quick response
Deze node wordt op dezelfde manier gebruikt als de node “Capture buttons” wanneer je de chatbot in WhatsApp-kanalen wilt gebruiken. Er kunnen maximaal 3 knoppen of opties worden getoond.
Wat gebeurt er als een contactpersoon met een spraakbericht antwoordt?
Een contactpersoon kan een wachtende node ook beantwoorden met een spraakbericht of audiobestand. Lime Connect transcribeert de opname en de workflow gebruikt de tekst alsof de contactpersoon die heeft getypt. Transcriptie staat in elke organisatie aan, tenzij deze is uitgeschakeld. Hoe je transcriptie uitschakelt en hoeveel audio per dag wordt getranscribeerd, wordt beschreven in het gedeelte “Voice messages” van het Message Center.
Zo verwerkt elke node de tekst van een spraakbericht:
- Capture text, Capture email en Capture regex: De tekst wordt op dezelfde manier gecontroleerd als een getypt antwoord. Is de tekst geldig, dan volgt de workflow “If contact provided valid value” en slaat de tekst op in de variabele van de node. Zo niet, dan volgt de workflow “If contact provided invalid value”. Dit gebeurt bijvoorbeeld wanneer de contactpersoon een e-mailadres uitspreekt en de tekst “name at example dot com” luidt in plaats van “name@example.com”.
- Capture buttons, Capture carousel, WhatsApp list en WhatsApp quick response: Een spraakbericht selecteert nooit een optie, ook niet als de contactpersoon de naam ervan uitspreekt. De workflow volgt “If the contact does not respond or types any message”.
- Capture media: De tekst wordt niet gebruikt en kan deze node niet overslaan. De opname zelf telt als bestand: de workflow volgt “If contact provided valid media” als de node audiobestanden accepteert en “If contact provided invalid media” als deze alleen een ander bestandstype accepteert.
Als een opname niet kan worden getranscribeerd, bijvoorbeeld doordat de transcriptie is mislukt of het dagelijkse tegoed op is, volgen Capture text, Capture email en Capture regex “If contact provided invalid value” en slaan niets op. Als die uitgang niet is verbonden, blijft de node wachten. Nodes met opties blijven in dit geval altijd wachten. Als transcriptie voor je organisatie is uitgeschakeld, beantwoordt een spraakbericht deze nodes helemaal niet en blijft de node wachten.
De tekst beantwoordt alleen een node die al wachtte toen de contactpersoon het spraakbericht verzond. Als de workflow intussen is verdergegaan, bijvoorbeeld omdat de contactpersoon een antwoord typte voordat het transcript klaar was, wordt de tekst van het spraakbericht niet gebruikt.