MaviBot integriert sich mit TikTok – einer der am schnellsten wachsenden und beliebtesten Social-Media-Plattformen der Welt.

Diese Integration eröffnet ein neues Kapitel für das MaviBot-Ökosystem. TikTok, auf dem täglich Millionen von Nutzern interagieren, ist zum Zentrum moderner Kommunikation, Trends und neuer interaktiver Formate geworden. Unternehmen können nun jüngere Zielgruppen über eine der ansprechendsten Plattformen der Welt erreichen.

In diesem Artikel erfährst du:

  • wie du die Integration aktivierst;
  • welche Callbacks verfügbar sind;
  • welche Berechtigungen erteilt werden müssen.

Wir werden auch die regionale Verfügbarkeit und ihre Einschränkungen behandeln.

Wichtig

Die TikTok-Integration ist nicht in jedem Land verfügbar.

Die TikTok Messaging API ist derzeit nur in der offenen Beta in folgenden Regionen verfügbar:

  • Asien-Pazifik (APAC);
  • Lateinamerika;
  • Naher Osten;
  • Afrika (METAP);
  • Nordamerika (ohne die Vereinigten Staaten).

Das verbundene TikTok-Konto muss in einer dieser Regionen registriert sein.

Nachrichten von Nutzern aus den Vereinigten Staaten, dem Europäischen Wirtschaftsraum (EWR), der Schweiz oder dem Vereinigten Königreich können aufgrund von TikTok-Plattformbeschränkungen nicht empfangen werden.

Weitere Informationen findest du in der offiziellen TikTok-Dokumentation:

https://business-api.tiktok.com/portal/docs?id=1832184145137922

Bitte beachte

Bevor du einen TikTok-Chatbot erstellst, lies den Abschnitt So erstellst du einen Chatbot für Unternehmen.

Die Einschränkungen von TikTok-Buttons werden im Abschnitt Buttons unten beschrieben.

Die Integration von TikTok mit MaviBot ist mehr als nur ein weiterer Kanal – es ist eine Gelegenheit, mit Nutzern dort zu kommunizieren, wo sie die meiste Zeit verbringen, und hochgradig ansprechende Kundeninteraktionen aufzubauen.

Bereite dein TikTok-Konto vor

Bevor du dein Konto mit MaviBot verbindest, schalte es auf ein Geschäftskonto um.

Schritt 1

Öffne Einstellungen und Datenschutz.

Schritt 2

Öffne den Bereich Konto.

Schritt 3

Wähle Zu Geschäftskonto wechseln.

Schritt 4

Vervollständige dein Geschäftsprofil.

Erledigt! Dein Konto ist jetzt bereit, um mit MaviBot verbunden zu werden.

Verbinde dein TikTok-Konto

Öffne den Bereich Messenger in MaviBot und klicke auf TikTok.

Melde dich bei deinem TikTok-Konto an.

Gewähre MaviBot Zugriff auf dein Konto.

Wichtig

Wir empfehlen dringend, die Berechtigung zu erteilen für:

  • Lesen und Verwalten von Nachrichten;
  • Zugriff auf Kommentare;
  • Zugriff auf Profilinformationen;
  • Anzeigen von Videos.

Ohne diese Berechtigungen funktionieren der Chatbot und einige Callbacks möglicherweise nicht richtig.

Du kannst alle anderen Berechtigungen verweigern, wenn du sie nicht benötigst.

Wenn du später erforderliche Berechtigungen widerrufst, kannst du sie nur über die Einstellungen deines TikTok-Kontos wieder aktivieren.

Nach der Autorisierung wirst du zurück zum Bereich Messenger weitergeleitet, wo MaviBot eine Bestätigung anzeigt, dass die Integration erfolgreich war.

TikTok-Einschränkungen

  1. Ein Nutzer muss die Unterhaltung beginnen, bevor der Bot Nachrichten senden kann.
  2. Du kannst innerhalb von 48 Stunden nach Erhalt einer Nachricht von einem Nutzer bis zu 10 Nachrichten senden.
    • Beispiel: Wenn ein Nutzer dir eine Nachricht sendet, kannst du innerhalb der nächsten 48 Stunden bis zu 10 Antworten senden. Sendet der Nutzer später eine weitere Nachricht, beginnt ein neues 48-Stunden-Fenster mit einem weiteren Kontingent von 10 ausgehenden Nachrichten.
  3. Eine einzelne Nachricht kann nicht sowohl Text als auch ein Bild enthalten.
  4. Bildanhänge werden nur unterstützt, wenn sich sowohl der Absender als auch der Empfänger in Ländern befinden, in denen TikTok das Teilen von Bildern in privaten Nachrichten erlaubt.
  5. Die maximale Bildgröße beträgt 3 MB.
  6. Es kann nur ein Anhang in eine einzelne Nachricht eingefügt werden.

Callbacks

Neuer Kommentar

tiktok_client_new_comment <video_id>: <comment_text>

Wird ausgelöst, wenn ein Nutzer einen Kommentar zu einem deiner Videos hinterlässt.

Geteiltes Video

tiktok_client_share_post <shared_video_id> <url>

Wird ausgelöst, wenn ein Nutzer ein TikTok-Video in den Direktnachrichten des verbundenen Kontos teilt.

Client-Variablen

tiktok_comment_id

Speichert die Kommentar-ID.

Wird automatisch ausgefüllt, wenn ein Nutzer dein Video kommentiert, und verwendet, wenn auf diesen Kommentar geantwortet wird.

tiktok_comment_video_id

Speichert die ID des Videos, das den Kommentar erhalten hat.

Wird automatisch ausgefüllt, wenn ein Nutzer dein Video kommentiert.

tiktok_is_follower

Gibt True zurück, wenn der Nutzer deinem TikTok-Konto folgt.

tiktok_conversation_id

Speichert die Konversations-ID.

Wird automatisch erstellt, nachdem ein Nutzer die erste Direktnachricht gesendet hat.

Wichtig

Lösche diese Variable nicht.

Sie ist erforderlich, um Nachrichten an den Nutzer zu senden.

Buttons

Eine TikTok-Nachricht kann bis zu drei Buttons enthalten.

TikTok unterstützt zwei Button-Typen:

  • Callback-Buttons
  • URL-Buttons

Wichtig

Eine einzelne Nachricht kann Buttons von nur einem Typ enthalten.

Beispiel 1

Beispiel 2

Ergebnis

Bitte beachte

Button-Nachrichten werden auf TikTok Desktop nicht unterstützt.

Desktop-Nutzer sehen stattdessen die folgende Benachrichtigung:

In der mobilen Anwendung wird die Nachricht korrekt angezeigt.

Der auf dem Button angezeigte Text ist identisch mit dem Text, der nach dem Klicken an den Bot zurückgesendet wird.

Der Button-Text wird entweder aus dem Feld Antwortnachrichtentext oder dem Feld URL in den Button-Einstellungen übernommen.

Callback-Buttons

Werden als normale Buttons angezeigt.

Wenn geklickt, sendet TikTok im Namen des Nutzers eine Nachricht an den Bot, die den Button-Text enthält.

Maximale Länge: 20 Zeichen.

URL-Buttons

Werden als Links angezeigt.

Derzeit unterstützt TikTok das Öffnen von Webseiten beim Klicken auf URL-Buttons nicht.

Stattdessen sendet das Klicken auf den Button seinen Text an den Bot, genau wie bei einem Callback-Button.

Maximale Länge: 40 Zeichen.

Erfahre mehr über Callback-Buttons.

Funktionen

Auf einen Kommentar antworten

tiktok_create_comment(text, comment_video_id, comment_id)

Veröffentlicht eine Antwort auf einen TikTok-Kommentar.

Parameter Beschreibung
text Erforderlich. Antworttext.
comment_video_id Video-ID, die den Kommentar enthält. Optional. Wenn nicht angegeben, wird der Wert der Client-Variable tiktok_comment_video_id verwendet.
comment_id Kommentar-ID, auf die geantwortet werden soll. Optional. Wenn nicht angegeben, wird der Wert der Client-Variable tiktok_comment_id verwendet.