Engage met klanten via Khoros en sms-berichten
Met behulp van sms-berichten is het eenvoudig om een gesprek met klanten aan te gaan.
Een aantal use cases zijn:
- Stuur een melding, zoals een bezorgupdate
- Leid een telefoongesprek om naar tekstberichten
- Bulk stuur een bericht naar klanten
Wat je nodig hebt
Om te beginnen heb je het volgende nodig:
- Een Khoros-instantie die is verbonden met een telefoonnummer
- Een geregistreerde botgebruiker binnen de Khoros-instantie
- Een Flow.ai account en organisatie
Aan de slag gaan
Om uitgaande berichten te kunnen verzenden, moet je Flow.ai verbinden met Khoros, de Flow.ai REST API configureren en een stroom toevoegen om te activeren.
1. Flow.ai verbinden met Khoros
- Log in in je Flow.ai project
- Ga naar je integratie overzicht
- Voeg een nieuwe Khoros-integratie toe binnen het gedeelte Klantenservice
- Kies een botnaam
- Geef de gebruikersnaam en het wachtwoord van de bot op (neem contact op met Khoros-ondersteuning om een botgebruiker voor uw Khoros-instantie te maken)
- Voeg uw bedrijfssleutel toe (controleer de Khoros-ontwikkelaarsinstellingen om de naam te vinden)
- Voeg uw bedrijfssleutel toe (controleer de Khoros-ontwikkelaarsinstellingen om de naam te vinden)
- Kies SMS als kanaal
- Voeg het telefoonnummer dat is verbonden met Khoros toe als de externe ID
- Voeg hetzelfde telefoonnummer toe in het telefoonnummerveld
- Voeg [email protected] toe als het e-mailadres voor contact
Raadpleeg de installatie documentatie voor meer informatie.
2. Configureer de Flow.ai REST API
Met behulp van de REST API kun je een directe broadcast oproep doen naar Flow.ai met behulp van een klantentelefoonnummer (MSISN) dat een specifieke stroom zou activeren.
Op die manier kun je sms-berichten naar klanten sturen via de Khoros SMS-integratie.
- Ga naar het instellingenscherm van de organisatie (rechtsboven)
- Kies “API-sleutels”. Als je dit item niet ziet, heb je niet voldoende rechten voor de organisatie. Neem contact op met de eigenaar van de organisatie Flow.ai.
- Maak een nieuwe API-sleutel (kies de standaardinstellingen)
- Ga terug naar het project en open het integratie overzicht
- Voeg een nieuwe REST API-integratie toe
- Kies de API-sleutel uit de vervolgkeuzelijst en druk op Opslaan
- Kopieer het REST API-token en bewaar het voor later gebruik
3. Het maken van een Flow om het te activeren
We hebben alles klaar om een flow te activeren die een uitgaand bericht naar een gebruiker stuurt. Het enige dat ontbreekt, is een flow die moet worden geactiveerd. Voeg simpelweg een nieuwe flow toe en laat deze beginnen met een event. Bijvoorbeeld de naam van het event: Send SMS
.
Sleep een tekstantwoord onder de gebeurtenis. Voeg wat tekst toe zoals: This is a test message
Sla de flow op. Nu kunnen we de hele setup testen!
Testen
Je kunt de uitzending testen met een CURL-opdracht om de REST API aan te roepen.
Het volgende is een voorbeeld van een CURL-commando:
curl --location --request POST 'https://api.flow.ai/rest/v1/broadcast/instant' \
--header 'Content-Type: application/json' \
--header 'Authorization: sk_ab12abcd9876543210abcdefgh012345' \
--data-raw '{
"audience": [{
"name": "John Doe",
"phoneNumber": "+1234567890"
}],
"channel": {
"channelName": "khoros",
"externalId": "+0987654321"
},
"payload": {
"type": "event",
"eventName": "Send SMS"
}
}
'
Vervang de informatie:
Name | Description |
---|---|
API_TOKEN | Rest API token copied in step 2 |
CUSTOMER_NAME | Name of the customer (or anonymous ) |
CUSTOMER_MSISDN | Valid phone number in international format |
KHOROS_EXTERNAL_ID | Khoros external ID (phone number) |
EVENT_NAME | Event name of the flow to trigger |
curl --location --request POST 'https://api.flow.ai/rest/v1/broadcast/instant' \
--header 'Content-Type: application/json' \
--header 'Authorization: API_TOKEN' \
--data-raw '{
"audience": [{
"name": "CUSTOMER_NAME",
"phoneNumber": "CUSTOMER_MSISDN"
}],
"channel": {
"channelName": "khoros",
"externalId": "KHOROS_EXTERNAL_ID"
},
"payload": {
"type": "event",
"eventName": "EVENT_NAME"
}
}
'
Lees meer
Troubleshooting
- Controleer het meldingsoverzicht rechtsboven op eventuele fouten
- Check de Flow.ai chat logs, kies “Alle berichten” om alle inkomende en uitgaande REST API-aanroepen te bekijken