MaviBot s'intègre à TikTok, l'une des plateformes sociales les plus dynamiques et populaires au monde.

Cette intégration ouvre un nouveau chapitre pour l'écosystème MaviBot. TikTok, où des millions d'utilisateurs interagissent chaque jour, est devenu le centre de la communication moderne, des tendances et des nouveaux formats interactifs. Les entreprises peuvent désormais atteindre un public plus jeune via l'une des plateformes les plus engageantes au monde.

Dans cet article, vous apprendrez :

  • comment activer l'intégration ;
  • quels callbacks sont disponibles ;
  • quelles autorisations doivent être accordées.

Nous aborderons également la disponibilité régionale et ses limites.

Important

L'intégration TikTok n'est pas disponible dans tous les pays.

L'API de messagerie TikTok est actuellement disponible en version bêta ouverte uniquement dans :

  • Asie-Pacifique (APAC) ;
  • Amérique latine ;
  • Moyen-Orient ;
  • Afrique (METAP) ;
  • Amérique du Nord (à l'exception des États-Unis).

Le compte TikTok connecté doit être enregistré dans l'une de ces régions.

Les messages envoyés par les utilisateurs des États-Unis, de l'Espace économique européen (EEE), de la Suisse ou du Royaume-Uni ne peuvent pas être reçus en raison des restrictions de la plateforme TikTok.

Pour plus d'informations, consultez la documentation officielle de TikTok :

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

Veuillez noter

Avant de créer un chatbot TikTok, consultez la section Comment créer un chatbot pour entreprise.

Les limitations des boutons TikTok sont décrites dans la section Boutons ci-dessous.

Intégrer TikTok à MaviBot est plus qu'un simple canal supplémentaire : c'est une opportunité de communiquer avec les utilisateurs là où ils passent le plus de temps et de créer des interactions client très engageantes.

Préparer votre compte TikTok

Avant de connecter votre compte à MaviBot, passez-le en Compte Professionnel.

Étape 1

Ouvrez Paramètres et confidentialité.

Étape 2

Ouvrez la section Compte.

Étape 3

Sélectionnez Passer au compte professionnel.

Étape 4

Complétez votre profil professionnel.

Terminé ! Votre compte est maintenant prêt à être connecté à MaviBot.

Connecter votre compte TikTok

Ouvrez la section Messageries dans MaviBot et cliquez sur TikTok.

Connectez-vous à votre compte TikTok.

Accordez à MaviBot l'accès à votre compte.

Important

Nous recommandons vivement d'accorder l'autorisation de :

  • lire et gérer les messages ;
  • accéder aux commentaires ;
  • accéder aux informations du profil ;
  • voir les vidéos.

Sans ces autorisations, le chatbot et certains callbacks peuvent ne pas fonctionner correctement.

Vous pouvez refuser toute autre autorisation si vous n'en avez pas besoin.

Si vous révoquez ultérieurement des autorisations requises, vous ne pouvez les réactiver qu'à partir des paramètres de votre compte TikTok.

Après l'autorisation, vous serez redirigé vers la section Messageries, où MaviBot affichera une confirmation de la réussite de l'intégration.

Limitations de TikTok

  1. Un utilisateur doit démarrer la conversation avant que le bot puisse envoyer des messages.
  2. Vous pouvez envoyer jusqu'à 10 messages dans les 48 heures suivant la réception d'un message d'un utilisateur.
    • Exemple : si un utilisateur vous envoie un message, vous pouvez envoyer jusqu'à 10 réponses pendant les 48 heures suivantes. Si l'utilisateur envoie un autre message plus tard, une nouvelle fenêtre de 48 heures commence avec une nouvelle allocation de 10 messages sortants.
  3. Un seul message ne peut pas contenir à la fois du texte et une image.
  4. Les pièces jointes image sont prises en charge uniquement si l'expéditeur et le destinataire se trouvent dans des pays où TikTok autorise le partage d'images dans les messages privés.
  5. La taille maximale de l'image est de 3 Mo.
  6. Une seule pièce jointe peut être incluse dans un message.

Callbacks

Nouveau commentaire

tiktok_client_new_comment <video_id>: <comment_text>

Déclenché lorsqu'un utilisateur laisse un commentaire sur l'une de vos vidéos.

Vidéo partagée

tiktok_client_share_post <shared_video_id> <url>

Déclenché lorsqu'un utilisateur partage une vidéo TikTok dans les messages directs du compte connecté.

Variables client

tiktok_comment_id

Stocke l'ID du commentaire.

Remplie automatiquement lorsqu'un utilisateur commente votre vidéo et utilisée lors de la réponse à ce commentaire.

tiktok_comment_video_id

Stocke l'ID de la vidéo qui a reçu le commentaire.

Remplie automatiquement lorsqu'un utilisateur commente votre vidéo.

tiktok_is_follower

Renvoie Vrai si l'utilisateur suit votre compte TikTok.

tiktok_conversation_id

Stocke l'ID de la conversation.

Créée automatiquement après qu'un utilisateur a envoyé le premier message direct.

Important

Ne supprimez pas cette variable.

Elle est nécessaire pour envoyer des messages à l'utilisateur.

Boutons

Un message TikTok peut contenir jusqu'à trois boutons.

TikTok prend en charge deux types de boutons :

  • Boutons de callback
  • Boutons URL

Important

Un seul message peut contenir des boutons d'un seul type.

Exemple 1

Exemple 2

Résultat

Veuillez noter

Les messages avec boutons ne sont pas pris en charge sur TikTok Desktop.

Les utilisateurs de bureau verront la notification suivante à la place :

Dans l'application mobile, le message s'affiche correctement.

Le texte affiché sur le bouton est identique au texte renvoyé au bot après avoir été cliqué.

Le texte du bouton est extrait soit du champ Texte du message de réponse, soit du champ URL dans les paramètres du bouton.

Boutons de callback

Affichés comme des boutons normaux.

Lorsqu'ils sont cliqués, TikTok envoie un message au bot au nom de l'utilisateur contenant le texte du bouton.

Longueur maximale : 20 caractères.

Boutons URL

Affichés comme des liens.

Actuellement, TikTok ne prend pas en charge l'ouverture de pages web lorsque les boutons URL sont cliqués.

Au lieu de cela, cliquer sur le bouton envoie son texte au bot, comme un bouton de callback.

Longueur maximale : 40 caractères.

En savoir plus sur les boutons de callback.

Fonctions

Répondre à un commentaire

tiktok_create_comment(text, comment_video_id, comment_id)

Publie une réponse à un commentaire TikTok.

Paramètre Description
text Obligatoire. Texte de la réponse.
comment_video_id ID de la vidéo contenant le commentaire. Optionnel. S'il est omis, la valeur de la variable client tiktok_comment_video_id est utilisée.
comment_id ID du commentaire auquel répondre. Optionnel. S'il est omis, la valeur de la variable client tiktok_comment_id est utilisée.