Twilio

Mache Anrufe und Versende SMS Nachrichten und reagiere auf eingehende Anrufe und SMS Nachrichten über die Twilio Voice und SMS API.

Um dieses Plugin zu nutzen brauchst du einen Twilio account und musst dir dort eine Telefonnummer bestellen. Das bestellen und nutzen von Telefonnummern auf Twilio ist ein kostenpflichtiger Service.

Damit adaptor:ex auf eingehende SMS reagieren und Anrufe verwalten kann, muss der adaptor:ex Server mit dem Internet verbunden und aus dem Internet erreichbar sein.

adaptor:ex aus dem Internet erreichbar machen

Starte deinen adaptor:ex server mit der option --host um eine Webadresse als hostname zu übergeben unter der, der Rechner oder Server auf dem adaptor:ex läuft, aus dem Internet zu erreichen ist. Z.B.:

adaptorex --host https://myveryownwebdomain.org

Du kannst natürlich auch die statische IP angeben

adaptorex --host 123.456.7.890

Wenn du adaptor:ex mit Twilio auf einem lokalen Rechner benutzen willst musst du einen IP Weiterleitungs Service nutzen.

Als Besitzer einer Fritzbox kannst du dir z.B. eine MyFritz Adresse einrichten und auf deiner Fritzbox Port Weitergaben zum adaptor:ex Server auf deinem Rechner einrichten.

Eine andere Möglichkeit ist es einen Service wie ngrok zu nutzen der die Weiterleitung für dich übernimmt und eine Domain bereitstellt.

Eine Telefonnummer einrichten

In adaptor:ex, öffne Game > settings und füge das Twilio Plugin zu deinem Game hinzu

Um Twilio und adaptor:ex zu verbinden brauchst du deine Twilio SID, deinen Twilio Token und eine Twilio Telefonnummer.

SID und Token

Registriere dich auf der Twilio Webseite: www.twilio.com/

Öffne dein Twilio Nutzerkonto um auf das Dashboard zu gelangen. Auf der Startseite findest du deine SID und den Token.

Kopiere die beiden Werte und trage sie in adaptor:ex in den Twilio Plugin Settings im jeweiligen Feld ein.

Telefonnummer

Um eine telefonnummer hinzuzufügen wähle in deinem Twilio Account Dashboard Phone Numbers > Manage > Buy A Number aus. Stelle sicher, dass du eine Nummer auswählst die sowohl "Voice" als auch "SMS" Fähigkeit hat.

Die nationalen und Twilio internen Regelungen zum Erwerb einer Telefonnummer ändern sich immer wieder, deshalb können wir an dieser Stelle leider keine genaue Anleitung bereitstellen. Twilio wird entsprechende Nachweise von dir verlangen, bevor du endgültig eine Nummer bestellen kannst.

Wenn du eine Telefonnummer erstanden hast, erstelle im Twilio Plugin ein neues PHONE Item.

Wähle den info Reiter aus um deinem Twilio phone einen Namen zu geben. Das Twilio Telefon im Beispiel hat den Namen "Kuhlmann". Eine Figur aus unserem Messenger Adventure Lockdown.

Gib unter settings die Twilio Telefonnummer (phone_number) an.

Achte darauf, dass die phone_number keine Leerzeichen enthält und mit + beginnt.

klicke anschließend auf SAVE um das Item zu erstellen.

Deine Telefonnummer kann jetzt mit Send SMS über die Twilio API SMS versenden.

Webhooks einrichten

Um SMS zu empfangen und Anrufe tätigen zu können musst du Twilio noch auf deinen adaptor:ex Server verweisen.

Öffne die Twilio Plugin Settings in adaptor:ex und wähle das Phone Item aus, dass du im Twilio Account anbinden willst.

Kopiere die Angaben unter webhooks

und füge sie in deinem twilio Account in den Einstellungen der Telefonnummer (Phone Numbers > Manage > Active Numbers) ein:

Default Level angeben

Das default level kannst du in den Settings des Twilio phone angeben. Wähle es aus den Levels, die du in deinem Game erstellt hast, aus.

Wird dein Twilio phone per SMS oder Anruf Kontaktiert und ist nicht bereits in einer Incoming SMS oder Incoming Call Action mit dieser Telefonnummer, wird eine Session des default level gestartet.

Auch wenn das entsprechende default level bereits aktiv ist wird, auch ohne aktive SMS oder Call action, keine weitere default level Session gestartet.

Das kontaktierende player Data Item ist innerhalb des Levels als "Player" argument adressierbar.

Gibt es kein player Data Item mit der Kontaktierenden Telefonnummer, wird ein neues Data Item in der player Collection erstellt.

Telefonnummern von verschiedenen Accounts

Du kannst für jedes Phone eigene Accountdaten festlegen indem du in den Settings des Phone sid und token angibst.

Nur Phone Items, die selbst keine sid und keinen token angeben werden über sid und token des Twilio Plugins verbunden.

Actions

Verschicke eine SMS von einer Twilio Telefonnummer mit Send SMS.

Reagiere auf eingehende SMS mit On Incoming SMS.

Starte einen Anruf mit Outgoing Call.

Reagiere auf eingehende Anrufe mit On Incoming Call

Starte einen Studio Flow den du in Twilio Studio erstellt hast mit Twilio Studio Flow