# Comment créer un chatbot TikTok

MaviBot dispose d’une intégration avec TikTok — l’une des plateformes sociales les plus dynamiques et populaires au monde. Cela marque un nouveau chapitre pour notre écosystème. TikTok, où des millions d’utilisateurs interagissent chaque jour, est l’épicentre de la communication moderne, des tendances et des nouveaux formats interactifs. Cette intégration permet aux entreprises et aux projets de se connecter à un public plus jeune à un tout autre niveau.

<div data-with-frame="true"><figure><img src="/files/0d6056d4c6319badd66934d93154395ba0c5fc1e" alt="" width="375"><figcaption></figcaption></figure></div>

Nous examinerons les aspects techniques du processus :

* les étapes requises pour activer l’intégration
* les callbacks disponibles
* les autorisations qui doivent être accordées

De plus, nous nous concentrerons plus précisément sur les nuances de la disponibilité régionale.

{% hint style="warning" %}
Il est important de noter que l’intégration TikTok n’est pas disponible dans tous les pays et dépend de zones économiques spécifiques où la plateforme prend officiellement en charge ces fonctionnalités. Nous préciserons où elle peut être configurée immédiatement et où des limitations peuvent s’appliquer.

L’API de messagerie TikTok est actuellement en test bêta ouvert dans la région Asie-Pacifique, en Amérique latine, au Moyen-Orient, en Afrique (METAP) et en Amérique du Nord (à l’exclusion des États-Unis). Le compte connecté doit être enregistré dans l’une de ces régions.

Si un utilisateur des États-Unis, de l’Espace économique européen (EEE), de la Suisse ou du Royaume-Uni envoie un message, il ne sera pas reçu en raison des restrictions de TikTok.

[Consultez la documentation officielle de TikTok pour plus de détails.](https://business-api.tiktok.com/portal/docs?id=1832184145137922)
{% endhint %}

{% hint style="success" %}
Veuillez noter !

Pour créer et configurer un chatbot pour TikTok, veuillez vous référer à la section « Comment créer un chatbot pour une entreprise ».

Les spécifications des boutons TikTok sont couvertes [ici](#knopki).
{% endhint %}

Intégrer TikTok à MaviBot est bien plus qu’une mise à jour technique — c’est l’occasion d’être à l’avant-garde de la communication avec votre audience, d’utiliser le canal le plus en vogue pour la promotion et d’interagir avec les utilisateurs là où ils passent leur temps.

### Comment préparer votre compte pour l’intégration

Commençons par l’étape la plus importante — configurer correctement la connexion.

Avant de connecter votre compte, vous devez passer à un compte professionnel.

Étape 1 : Allez dans la section **« Paramètres et confidentialité »** section.

<div data-with-frame="true"><figure><img src="/files/e77b5e61379f88d98ee06e6af9d23372721df6a9" alt="" width="375"><figcaption></figcaption></figure></div>

Étape 2 : Ensuite, allez dans la section « Compte ».

<div data-with-frame="true"><figure><img src="/files/3fe89199ad8f17742db2f821e1b98b8a30dd43ac" alt="" width="375"><figcaption></figcaption></figure></div>

Étape 3 : Cliquez sur **« Passer à un compte professionnel »**.

<div data-with-frame="true"><figure><img src="/files/118cc554424aaaef693dfa15b86e75b28241b48b" alt="" width="375"><figcaption></figcaption></figure></div>

Étape 4 : Renseignez les informations de votre entreprise.

<div data-with-frame="true"><figure><img src="/files/315d38d230ad5591cd8ef9559c3b16f1a5a9464c" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/4ef99e313194bd230bfb3228256e06c430a99323" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/54050cf26cc27a1619ea76abca3da7067a2178d1" alt="" width="375"><figcaption></figcaption></figure></div>

C’est fait ! Votre compte est maintenant prêt à être connecté à MaviBot.

<div data-with-frame="true"><figure><img src="/files/eb13885470aa90a4c3eb74adcddd2e83aee990e6" alt="" width="375"><figcaption></figcaption></figure></div>

## Comment connecter votre compte à MaviBot

Allez dans la section **« Messageries »** et cliquez sur le bouton **TikTok** .

<div data-with-frame="true"><figure><img src="/files/494f17d3999784fce441d3bfe731f1112ea5a6cb" alt=""><figcaption></figcaption></figure></div>

Ensuite, connectez-vous à votre compte TikTok dans la fenêtre qui s’affiche.

<div data-with-frame="true"><figure><img src="/files/85ec781ea737cdd9853e46511d1d64ac80eb8e30" alt=""><figcaption></figcaption></figure></div>

Et accordez à MaviBot l’accès à votre compte.

{% hint style="danger" %}
Important !

Nous vous conseillons vivement d’accorder l’accès aux commentaires, aux messages, aux informations de profil et à la possibilité de voir vos vidéos. Le bot et ses callbacks peuvent tout simplement ne pas fonctionner sans ces autorisations, .

Vous pouvez refuser ou retirer toutes les autres autorisations à votre discrétion.

Si vous révoquez plus tard l’une des autorisations essentielles au bon fonctionnement du chatbot, vous ne pourrez les réactiver qu’à partir des propres paramètres de TikTok.
{% endhint %}

Vous serez alors automatiquement redirigé vers la **« Messageries »** section dans MaviBot, où vous verrez une notification confirmant la réussite de l’intégration.

## Spécificités de TikTok

1. Pour pouvoir envoyer un message à un utilisateur, celui-ci doit d’abord lancer la discussion.
2. Vous pouvez envoyer jusqu’à 10 messages dans une période de 48 heures après avoir reçu un message d’un utilisateur TikTok.\
   \&#xNAN;*Exemple : si vous recevez un message d’un utilisateur, vous pouvez envoyer jusqu’à 10 messages dans les 48 heures suivantes. Si le même utilisateur envoie un autre message plus tard, une nouvelle fenêtre de 48 heures commencera, vous permettant d’envoyer 10 autres messages à cet utilisateur.*
3. Un message ne peut pas contenir simultanément du texte et une image.
4. L’envoi et la réception de pièces jointes image via l’API ne sont disponibles que si l’expéditeur et le destinataire se trouvent tous deux dans des pays prenant en charge les images dans les messages privés. Le partage d’images n’est pas disponible dans tous les pays.
5. La taille maximale d’une pièce jointe image est de 3 mégaoctets.
6. Un seul message ne peut contenir qu’une seule pièce jointe.

## Callbacks

tiktok\_client\_new\_comment \<video\_id> : \<comment\_text> - un utilisateur a laissé un commentaire sur votre vidéo.

<div data-with-frame="true"><figure><img src="/files/8eb4456cb4f1f7d646cf3ed2b9cdce89a223be75" alt="" width="563"><figcaption></figcaption></figure></div>

tiktok\_client\_share\_post \<shared\_video\_id> \<url> - un utilisateur a envoyé une vidéo dans les messages directs du compte connecté.

<div data-with-frame="true"><figure><img src="/files/f653c82f05daa7d580edc950a59dc94def227f31" alt="" width="563"><figcaption></figcaption></figure></div>

## Variables client stockées

tiktok\_comment\_id - ID du commentaire. Enregistré lorsqu’un utilisateur commente votre vidéo et utilisé pour répondre à ce commentaire.

tiktok\_comment\_video\_id - ID de la vidéo commentée. Enregistré lorsqu’un utilisateur commente votre vidéo et utilisé pour répondre au commentaire.

tiktok\_is\_follower - devient True si l’utilisateur suit votre compte.

tiktok\_conversation\_id - ID de discussion. Généré après qu’un utilisateur envoie un message dans la discussion. Requis pour l’envoi de messages ; ne supprimez pas !

## Boutons

Le nombre maximal de boutons dans un seul message est de 3.

TikTok prend en charge deux types de boutons : callback et « default » (URL). <mark style="color:$danger;">**H**</mark><mark style="color:$danger;">**owever, un seul message ne peut contenir que des boutons d’un seul type.**</mark>

Exemple 1.

<div data-with-frame="true"><figure><img src="/files/3cd366d3c911aaee197a4877d0a080f87dd24b1b" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/4afbc2c19efa7bab185b1d163e33e01a3e8c5d7e" alt=""><figcaption></figcaption></figure></div>

Exemple 2.

<div data-with-frame="true"><figure><img src="/files/debaa48810640caa8352156878527d7321bba6bf" alt=""><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/68217b61731eb441a2aa1d6ed18e5d8dc5580f12" alt=""><figcaption></figcaption></figure></div>

**Résultat**

<div data-with-frame="true"><figure><img src="/files/520322b566fb023137e4c030e7cec18ba77d68ea" alt="" width="375"><figcaption></figcaption></figure></div>

**Veuillez noter !**

***Les messages avec boutons ne sont pas disponibles sur TikTok Desktop.*** Dans le chat de bureau, vous verrez une notification comme celle-ci :

<div data-with-frame="true"><figure><img src="/files/8b053ed8a7988f7dadbca3890ff8990c7cfccf10" alt="" width="563"><figcaption></figcaption></figure></div>

Cependant, dans l’application mobile, le message s’affichera ***correctement***:

<div data-with-frame="true"><figure><img src="/files/296d7f45298fca06be09f8d46499a3e5b1881ed7" alt="" width="375"><figcaption></figcaption></figure></div>

Le texte affiché sur le bouton et le texte envoyé au bot lors du clic sont identiques. Le bouton est généré à l’aide des données du champ « Texte du message de réponse » ou « URL » dans les paramètres du bouton.

1. Les boutons callback apparaissent comme des boutons normaux. Lorsqu’on clique dessus, ils envoient un message dans le chat au nom de l’utilisateur, contenant le texte du bouton. La longueur maximale est de 20 caractères.
2. Les boutons URL apparaissent comme des liens. Cependant, leur comportement est le même que celui des boutons callback. Actuellement, TikTok ne prend pas en charge la création de boutons qui ouvrent une page web à l’URL spécifiée lorsqu’on clique dessus. La longueur maximale est de 40 caractères.

{% hint style="success" %}
En savoir plus sur l’utilisation de [boutons callback](/doc/fr/chatbot/builder/boutons.md#how-to-add-a-callback-button-facebook-telegram) dans MaviBot ici.
{% endhint %}

## Fonctions

Comment répondre à un commentaire :

tiktok\_create\_comment(text, comment\_video\_id, comment\_id) - publie une réponse au commentaire spécifié.

<table><thead><tr><th width="276.55859375">Paramètre</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark> text</td><td>paramètre requis, le texte du commentaire</td></tr><tr><td>comment_video_id</td><td>L’ID de la vidéo sur laquelle le commentaire est publié. Il s’agit d’un paramètre facultatif ; s’il n’est pas fourni, la valeur sera prise à partir de la <em>variable client tiktok_comment_video_id</em> .</td></tr><tr><td>comment_id</td><td>L’ID du commentaire auquel répondre. Il s’agit d’un paramètre facultatif ; s’il n’est pas fourni, la valeur de la <em>variable client tiktok_comment_id</em> sera utilisée.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/fr/chatbot/messageries/tiktok/chatbot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.