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