Messenger-Plattform

Eisbrecher

Eisbrecher bieten Nutzer*innen die Möglichkeit, mithilfe einer Liste häufig gestellter Fragen eine Unterhaltung mit einem Unternehmen zu beginnen. Über die Ice Breaker API können maximal vier Fragen eingerichtet werden.

Seit dem 19. Oktober 2021 unterstützen Eisbrecher die Lokalisierung, damit Unternehmen je nach Gebietsschema der Benutzer*innen selbstdefinierte Fragen festlegen können. Die API wird ein neues Format haben und wir ermutigen Entwickler*innen dazu, das neue Format zu nutzen, um Informationen zu Eisbrechern festzulegen und abzurufen. Die Liste der unterstützten Gebietsschemata findest du hier.

Diese Funktion ist derzeit nicht auf dem Desktop verfügbar.

Eisbrecher einrichten

Neues Format (empfohlen)

curl -X POST -H "Content-Type: application/json" -d '{
     "platform": "instagram",
     "ice_breakers":[
       {
          "call_to_actions":[
             {
                "question":"

Altes Format (sollte nicht für eine neue Eisbrechereinrichtung verwendet werden)

curl -X POST -H "Content-Type: application/json" -d '{
  "platform": "instagram",
  "ice_breakers":[
     {
        "question": "

Eisbrecher abrufen

Je nachdem, wie der Eisbrecher eingerichtet ist, gibt die GET-Anfrage ein anderes Format zurück. Es gilt folgendes Verhalten:

  • Wenn der Eisbrecher im alten Format eingerichtet ist, gibt die GET-Anfrage eine Antwort im alten Format zurück.
  • Wenn der Eisbrecher im neuen Format eingerichtet ist, gibt die GET-Anfrage eine Antwort im neuen Format zurück.

Wir empfehlen Entwickler*innen, zum neuen Format zu migrieren, da wir das alte Format einstellen werden.

curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>

Antwort im neuen Format

{
   "data": [
        {
          "call_to_actions" : [
               {
                "question": "

Antwort im alten Format

{
   "data": [
        {
          "ice_breakers": [
            {
                "question": "

Eisbrecher löschen

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "ice_breakers",
  ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"

Webhook-Event

Um Postback-Webhooks von Eisbrechern zu empfangen, muss deine App den Webhook messaging_postbacks ab Version 8.0 unter dem Thema „Instagram“ in den App-Einstellungen abonniert haben.

Der Webhook empfängt eine JSON-Payload wie im Beispiel unten.

{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "postback": {
            "title": "<SELECTED_ICEBREAKER_QUESTION>",
            "payload": "<USER_DEFINED_PAYLOAD>",
          }
        }
      ]
    }
  ]
}

Unterstützung für Entwickler*innen