> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/tiktok/tiktok.md).

# TikTok Events API

[TikTok for Business](https://www.tiktok.com/business/en) est une plateforme mondiale conçue pour donner aux marques et aux spécialistes du marketing les solutions nécessaires pour être des conteurs créatifs et interagir de manière pertinente avec la communauté TikTok.\
L'Events API TikTok est une intégration server-side qui vous permet de partager directement avec TikTok les événements des visiteurs du site web et de l'application à l'aide de leur [Events API pour Web](https://business-api.tiktok.com/portal/docs?id=1771100865818625) et [Events API pour App](https://business-api.tiktok.com/portal/docs?id=1771101111730178) version 2.0.

{% hint style="warning" %}
Le [Events API pour APP](https://business-api.tiktok.com/portal/docs?id=1771101111730178) le support est actuellement en phase de test bêta.
{% endhint %}

## Fonctionnalités clés

La destination TikTok Events API offre les fonctionnalités clés suivantes :

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspond [Le one de TikTok](https://business-api.tiktok.com/portal/docs?rid=959icq5stjr\&id=1771100779668482), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-items**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) le tableau est envoyé à TikTok.
* **Prise en charge du code d'événement de test**: validation en temps réel dans vos environnements de test avec le champ <mark style="color:bleu;">`test_event_code`</mark>.

## Configuration de la destination

Avant de commencer avec cette destination, assurez-vous de pouvoir accéder à [TikTok Ads Manager](https://ads.tiktok.com).

{% hint style="warning" %}
Les événements personnalisés TikTok sont disponibles à des fins de reporting et de création d'audience. L'optimisation n'est actuellement PAS prise en charge.
{% endhint %}

### Configuration

<table><thead><tr><th width="359">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>jeton d’accès</code></td><td><em><strong><code>Obligatoire</code></strong></em> pour <a href="https://business-api.tiktok.com/portal/docs?id=1771100865818625">événements Web</a>.<br>Votre <a href="https://business-api.tiktok.com/portal/docs?id=1771101130925058">jeton d'accès API</a> tel que fourni par TikTok. Plus de détails sont disponibles en suivant ce <a href="https://ads.tiktok.com/gateway/docs/index?identify_key=2b9b4278e47b275f36e7c39a4af4ba067d088e031d5f5fe45d381559ac89ba48&#x26;language=ENGLISH&#x26;doc_id=1727537566862337#item-link-How%20to%20generate%20an%20access%20token">LINK</a>.</td></tr><tr><td><code>Pixel ID</code></td><td><em><strong><code>Obligatoire</code></strong></em> pour <a href="https://business-api.tiktok.com/portal/docs?id=1771100865818625">événements Web</a>.<br>Votre identifiant pixel tel que fourni par TikTok. Plus de détails sont disponibles en suivant ce <a href="https://business-api.tiktok.com/portal/docs?id=1771101001228290#item-link-Q2%3A%20Where%20can%20I%20find%20the%20Pixel%20Code%3F">LINK</a>.</td></tr><tr><td><code>App ID</code></td><td><em><strong><code>Obligatoire</code></strong></em> pour <a href="https://business-api.tiktok.com/portal/docs?id=1771101111730178">événements App</a>.<br>Votre identifiant d'application tel que fourni par TikTok. Plus de détails sont disponibles en suivant ce <a href="https://business-api.tiktok.com/gateway/docs/index?identify_key=c0138ffadd90a955c1f0670a56fe348d1d40680b3c89461e09f78ed26785164b&#x26;language=ENGLISH&#x26;doc_id=1771101111730178#item-link-Create%20an%20App%20in%20Events%20Manager%20and%20obtain%20an%20access%20token">LINK</a>.</td></tr><tr><td><code>Code d'événement de test</code></td><td>Pour <a href="https://business-api.tiktok.com/portal/docs?id=1771100865818625">événements Web</a> uniquement. Ceci est utilisé pour tester le suivi des événements avant le déploiement en production. Ce code se trouve dans les <a href="https://ads.tiktok.com/">TikTok Ads Manager</a> suivant <code>Assets</code> ➜ <code>Événements</code> ➜ <code>Gérer (Web Events)</code> ➜ Sélectionnez votre pixel ➜ <code>Test Events (onglet)</code> <strong>[1]</strong></td></tr><tr><td><code>Correspondance des événements</code></td><td>Modifiez le mappage standard entre les événements TikTok et les vôtres ou ajoutez de nouveaux mappages : les événements personnalisés sont également pris en charge. Plus de détails sur la configuration des événements Web TikTok personnalisés sont disponibles en suivant ce <a href="https://business-api.tiktok.com/portal/docs?id=1740858531237890">LINK</a>.</td></tr><tr><td><code>Propriétés d'événement personnalisées</code></td><td>Envoyez des propriétés d'événement personnalisées.</td></tr><tr><td><code>Propriétés utilisateur personnalisées</code></td><td>Envoyez des propriétés utilisateur personnalisées.</td></tr><tr><td><code>Mappage d'événement TikTok "ViewContent"</code></td><td>Sélectionnez <mark style="color:bleu;"><code>page_view</code></mark>, <mark style="color:bleu;"><code>view_item</code></mark> ou les deux pour envoyer à TikTok <mark style="color:bleu;"><code>ViewContent</code></mark> correspondra à l'événement. Voir <a href="#quick-reference">Référence rapide</a> pour plus de détails sur le mappage d'événements.</td></tr><tr><td><code>Source d'événement Autodiscovery</code></td><td>Activez cette option pour définir TikTok <code>event_source</code> en fonction de la valeur fournie dans le champ "Smart Mapping" <code>Type d'expérience</code> ou dans la propriété standard <code>context.app</code> . Le champ "Smart Mapping" <code>Event Source</code> a priorité sur cette option.</td></tr><tr><td><code>Ne pas mettre l'ID utilisateur en minuscules</code></td><td>Lorsque cette option est activée et que le <code>ID utilisateur</code> (voir <code>Mappage intelligent</code> section) est fournie en texte clair, l'identifiant utilisateur n'est pas converti en minuscules avant d'appliquer l'algorithme de hachage SHA256.</td></tr></tbody></table>

{% hint style="info" %}
**1.** Le <mark style="color:bleu;">`Code d'événement de test`</mark> ne peut être défini que dans les environnements de test, car TikTok n'enregistrera pas les données provenant d'événements en production lorsque ce code est inclus. Plus de détails sont disponibles en suivant ce [LINK](https://business-api.tiktok.com/portal/docs?id=1771100984456193).
{% endhint %}

## Référence rapide

{% hint style="info" %}
Les événements standards TikTok sont détaillés dans ce [LINK](https://business-api.tiktok.com/portal/docs?id=1771101186666498).
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Commanders Act Events</th><th>TikTok Events</th></tr></thead><tbody><tr><td><code>achieve_level</code></td><td><code>AchieveLevel</code> <strong>[2]</strong></td></tr><tr><td><code>add_payment_info</code></td><td><code>AddPaymentInfo</code></td></tr><tr><td><code>add_to_cart</code></td><td><code>AddToCart</code></td></tr><tr><td><code>add_to_wishlist</code></td><td><code>AddToWishlist</code></td></tr><tr><td><code>application_approval</code></td><td><code>ApplicationApproval</code> <strong>[1]</strong></td></tr><tr><td><code>begin_checkout</code></td><td><code>InitiateCheckout</code> <strong>[1]</strong></td></tr><tr><td><p><code>click_button</code></p><p><code>view_content</code></p><p><code>page_view</code> <strong>[3]</strong></p><p><code>view_item</code> <strong>[3]</strong></p></td><td><code>ViewContent</code> <strong>[3]</strong></td></tr><tr><td><code>complete_tutorial</code></td><td><code>CompleteTutorial</code> <strong>[2]</strong></td></tr><tr><td><code>create_group</code></td><td><code>CreateGroup</code> <strong>[2]</strong></td></tr><tr><td><code>create_role</code></td><td><code>CreateRole</code> <strong>[2]</strong></td></tr><tr><td><code>customize_product</code></td><td><code>CustomizeProduct</code> <strong>[1]</strong></td></tr><tr><td><p><code>purchase</code></p><p><code>complete_payment</code></p></td><td><code>Purchase</code></td></tr><tr><td><code>contact</code></td><td><code>Contact</code> <strong>[1]</strong></td></tr><tr><td><code>download</code></td><td><code>Download</code> <strong>[1]</strong></td></tr><tr><td><code>find_location</code></td><td><code>FindLocation</code> <strong>[1]</strong></td></tr><tr><td><p><code>submit_form</code></p><p><code>generate_lead</code></p></td><td><code>Lead</code> <strong>[1]</strong></td></tr><tr><td><code>generate_lead</code></td><td><code>GenerateLead</code> <strong>[2]</strong></td></tr><tr><td><code>in_app_ad_click</code></td><td><code>InAppADClick</code> <strong>[2]</strong></td></tr><tr><td><code>in_app_ad_impr</code></td><td><code>InAppAdImpr</code> <strong>[2]</strong></td></tr><tr><td><code>install_app</code></td><td><code>InstallApp</code> <strong>[2]</strong></td></tr><tr><td><code>join_group</code></td><td><code>JoinGroup</code> <strong>[2]</strong></td></tr><tr><td><code>launch_app</code></td><td><code>LaunchAPP</code> <strong>[2]</strong></td></tr><tr><td><code>loan_application</code></td><td><code>LoanApplication</code> <strong>[2]</strong></td></tr><tr><td><code>loan_approval</code></td><td><code>LoanApproval</code> <strong>[2]</strong></td></tr><tr><td><code>loan_disbursal</code></td><td><code>LoanDisbursal</code> <strong>[2]</strong></td></tr><tr><td><code>login</code></td><td><code>Login</code> <strong>[2]</strong></td></tr><tr><td><code>rate</code></td><td><code>Rate</code> <strong>[2]</strong></td></tr><tr><td><code>schedule</code></td><td><code>Schedule</code> <strong>[1]</strong></td></tr><tr><td><code>search</code></td><td><code>Search</code></td></tr><tr><td><code>sign_up</code></td><td><p><code>CompleteRegistration</code> <strong>[1]</strong></p><p><code>Registration</code> <strong>[2]</strong></p></td></tr><tr><td><code>spend_credits</code></td><td><code>SpendCredits</code> <strong>[2]</strong></td></tr><tr><td><code>start_trial</code></td><td><code>StartTrial</code></td></tr><tr><td><code>submit_application</code></td><td><code>SubmitApplication</code> <strong>[1]</strong></td></tr><tr><td><code>subscribe</code></td><td><code>Subscribe</code></td></tr><tr><td><code>unlock_achievement</code></td><td><code>UnlockAchievement</code> <strong>[2]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Pour les événements Web, hors ligne et CRM uniquement. Voir <mark style="color:bleu;">`Source d'événement Autodiscovery`</mark> dans [Configuration](#configuration) pour plus de détails.\
**2.** Pour les événements App uniquement. Voir <mark style="color:bleu;">`Source d'événement Autodiscovery`</mark> dans [Configuration](#configuration) pour plus de détails.\
**3.** Voir <mark style="color:bleu;">`Mappage d'événement TikTok "ViewContent"`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Mappage intelligent](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.\
Le pixel client-side TikTok enregistre un identifiant unique dans le cookie [**\_ttp**](https://business-api.tiktok.com/portal/docs?rid=4eezrhr6lg4\&id=1771100936446977)**,** qui est utilisé pour faire correspondre les événements des visiteurs du site web avec les publicités TikTok. Cette destination commence par récupérer cet identifiant depuis <mark style="color:bleu;">`partners.tiktok.ttp`</mark> . S'il n'est pas présent, elle recherche le cookie mentionné précédemment [**\_ttp**](https://business-api.tiktok.com/portal/docs?rid=4eezrhr6lg4\&id=1771100936446977) et définit TikTok <mark style="color:bleu;">`data.0.user.ttp`</mark> avec la valeur obtenue.\
Le [TikTok Click ID](https://business-api.tiktok.com/portal/docs?rid=4eezrhr6lg4\&id=1771100879787009) est un paramètre de suivi qui est ajouté aux URL de page de destination de votre annonce. Cette destination vérifie si <mark style="color:bleu;">`partners.tiktok.ttclid`</mark> est défini avec la valeur ttclid. S'il n'est pas présent, elle recherche le cookie <mark style="color:bleu;">ttclid</mark>. Si aucun n'est trouvé, elle tente d'analyser la valeur à partir de <mark style="color:bleu;">`context.page.url`</mark> .
{% endhint %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th width="188">Champs Smart Mapping</th><th width="285">Propriétés par défaut de Commanders Act</th><th width="426">Propriétés TikTok</th></tr></thead><tbody><tr><td><code>Event Source</code></td><td><code>partners.tiktok.event_source</code></td><td><code>event_source</code> <strong>[*][1]</strong></td></tr><tr><td><code>-</code></td><td><p><code>Pixel ID</code></p><p><code>App ID</code></p></td><td><code>event_source_id</code> <strong>[*]</strong></td></tr><tr><td><code>-</code></td><td><code>event_name</code></td><td><code>data.0.event</code> <strong>[*][2]</strong></td></tr><tr><td><code>Horodatage de l’événement</code></td><td><code>context.event_timestamp</code></td><td><code>data.0.event_time</code> <strong>[*][3]</strong></td></tr><tr><td><code>ID de l'événement</code></td><td><code>id</code></td><td><code>data.0.event_id</code> <strong>[4]</strong></td></tr><tr><td><code>Click ID</code></td><td><code>partners.tiktok.ttclid</code></td><td><code>data.0.user.ttclid</code> <strong>[5]</strong></td></tr><tr><td><code>ID utilisateur</code></td><td><code>user.id</code></td><td><code>data.0.user.external_id</code> <strong>[6]</strong></td></tr><tr><td><code>Cookie ID</code></td><td><code>partners.tiktok.ttp</code></td><td><code>data.0.user.ttp</code> <strong>[7]</strong></td></tr><tr><td><code>URL de la page</code></td><td><code>context.page.url</code></td><td><code>data.0.page.url</code></td></tr><tr><td><code>Référent de la page</code></td><td><code>context.page.referrer</code></td><td><code>data.0.page.referrer</code></td></tr><tr><td><code>IDFV de l'appareil</code></td><td><code>context.device.idfv</code></td><td><code>data.0.user.idfv</code> <strong>[8]</strong></td></tr><tr><td><code>Statut ATT de l'appareil</code></td><td><code>context.device.att_status</code></td><td><code>data.0.user.att_status</code> <strong>[8][9]</strong></td></tr><tr><td><p><code>IDFA de l'appareil</code></p><p><code>GAID de l'appareil</code></p></td><td><code>context.device.advertising_id</code></td><td><code>data.0.user.idfa</code> <strong>[8]</strong><br><code>data.0.user.gaid</code> <strong>[10]</strong></td></tr><tr><td><code>App ID</code></td><td><code>context.app.namespace</code></td><td><code>data.0.app.app_id</code> <strong>[11]</strong></td></tr><tr><td><code>Nom de l'app</code></td><td><code>context.app.name</code></td><td><code>data.0.app.app_name</code></td></tr><tr><td><code>Version de l’application</code></td><td><code>context.app.version</code></td><td><code>data.0.app.app_version</code></td></tr><tr><td><code>e-mail utilisateur</code></td><td><code>user.email</code></td><td><code>data.0.user.email</code> <strong>[6]</strong></td></tr><tr><td><code>Téléphone de l'utilisateur</code></td><td><code>user.phone</code></td><td><code>data.0.user.phone</code> <strong>[6][12]</strong></td></tr><tr><td><code>IP de l'appareil</code></td><td><code>context.device.ip</code></td><td><code>data.0.user.ip</code></td></tr><tr><td><code>Agent utilisateur de l'appareil</code></td><td><code>context.device.user_agent</code></td><td><code>data.0.user.user_agent</code></td></tr><tr><td><code>Langue de l'appareil</code></td><td><code>context.device.language</code></td><td><code>data.0.user.locale</code> <strong>[13]</strong></td></tr><tr><td><code>Utilisation limitée des données</code></td><td><code>partners.tiktok.ldu</code></td><td><code>data.0.limited_data_use</code> <strong>[14]</strong></td></tr><tr><td><code>Type de contenu de l'élément</code></td><td><code>items.X.content_type</code></td><td><code>data.0.properties.contents.X.content_type</code> <strong>[15]</strong></td></tr><tr><td><code>ID de l'item</code></td><td><code>items.X.id</code></td><td><p><code>data.0.properties.contents.X.content_id</code></p><p><code>data.0.properties.content_ids</code> <strong>[16]</strong></p></td></tr><tr><td><code>Prix de l'article</code></td><td><code>items.X.product.price</code></td><td><code>data.0.properties.contents.X.price</code></td></tr><tr><td><code>Quantité de l'élément</code></td><td><code>items.X.quantity</code></td><td><code>data.0.properties.contents.X.quantity</code></td></tr><tr><td><code>Nom de l'item</code></td><td><code>items.X.product.name</code></td><td><code>data.0.properties.contents.X.content_name</code></td></tr><tr><td><code>Catégorie de l'item</code></td><td><code>items.X.product.category_1</code></td><td><code>data.0.properties.contents.X.content_category</code></td></tr><tr><td><code>Marque de l'item</code></td><td><code>items.X.product.brand</code></td><td><code>data.0.properties.contents.X.brand</code></td></tr><tr><td><code>Terme de recherche</code></td><td><code>search_term</code></td><td><code>data.0.properties.search_string</code> <strong>[17]</strong></td></tr><tr><td><code>ID de transaction</code></td><td><code>id</code></td><td><code>data.0.properties.order_id</code> <strong>[17]</strong></td></tr><tr><td><code>Identifiant de boutique</code></td><td><code>partners.tiktok.shop_id</code></td><td><code>data.0.properties.shop_id</code> <strong>[17]</strong></td></tr><tr><td><code>Statut de la transaction</code></td><td><code>status</code></td><td><code>data.0.properties.status</code> <strong>[17]</strong></td></tr><tr><td><code>Type de contenu</code></td><td><code>content_type</code></td><td><code>data.0.properties.content_type</code> <strong>[17]</strong></td></tr><tr><td><code>Devise</code></td><td><code>currency</code></td><td><code>data.0.properties.currency</code></td></tr><tr><td><code>Description</code></td><td><code>event_name</code></td><td><code>data.0.properties.description</code></td></tr><tr><td><code>Valeur de la transaction</code></td><td><code>valeur</code></td><td><code>data.0.properties.value</code></td></tr><tr><td><code>Liste des éléments</code></td><td><code>items.length</code></td><td><code>data.0.properties.num_items</code></td></tr><tr><td><code>-</code></td><td><code>Code d'événement de test</code></td><td><code>test_event_code</code></td></tr><tr><td><code>-</code></td><td><code>Propriétés d'événement personnalisées</code></td><td><code>[Any property]</code> <strong>[18]</strong></td></tr><tr><td><code>-</code></td><td><code>Propriétés utilisateur personnalisées</code></td><td><code>[Any property]</code> <strong>[19]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Valeurs prises en charge : <mark style="color:bleu;">`web`</mark> , <mark style="color:bleu;">`app`</mark> , <mark style="color:bleu;">`offline`</mark> , et <mark style="color:bleu;">`CRM`</mark> . Lorsque <mark style="color:bleu;">`Source d'événement Autodiscovery`</mark> est activé, si le champ "Smart Mapping" `Type d'expérience` est défini avec une propriété contenant la valeur `application native` ou que l'objet `context.app` possède au moins une propriété, alors celui-ci est défini avec `app` . Le "Smart Mapping" `Event Source` a priorité sur la fonctionnalité de découverte automatique. Valeur par défaut : `web` .\
**2.** Voir [Référence rapide](#quick-reference) pour plus de détails sur le mappage d'événements.\
**3.** S'il n'est pas fourni, l'horodatage actuel est utilisé.\
**4.** Requis si vous envoyez des événements Web à la fois depuis le pixel navigateur TikTok et depuis cette destination. Utilisé pour la déduplication avec <mark style="color:bleu;">`event_source_id`</mark> et <mark style="color:bleu;">`data[0].event`</mark> . Plus de détails sont disponibles en suivant ce [LINK](https://ads.tiktok.com/marketing_api/docs?id=1771100965992450).\
**5.** S'il n'est pas fourni, le cookie <mark style="color:bleu;">`ttclid`</mark> ou <mark style="color:bleu;">`context.page.url`</mark> est utilisé.\
**6.** S'il est fourni en texte clair, il est automatiquement haché avec SHA-256.\
**7.** S'il n'est pas fourni, le cookie <mark style="color:bleu;">`_ttp`</mark> est utilisé.\
**8.** Défini lorsque la propriété "Smart Mapping" <mark style="color:bleu;">`Plateforme de l’appareil`</mark> ou <mark style="color:bleu;">`context.device.type`</mark> est défini avec <mark style="color:bleu;">`iOS`</mark> (insensible à la casse).\
**9.** Valeurs prises en charge : <mark style="color:bleu;">`AUTHORIZED`</mark> , <mark style="color:bleu;">`DENIED`</mark> , <mark style="color:bleu;">`NOT_DETERMINED`</mark> , <mark style="color:bleu;">`RESTRICTED`</mark> et <mark style="color:bleu;">`NOT_APPLICABLE`</mark>. Plus de détails sont disponibles en suivant ce [LINK](https://business-api.tiktok.com/gateway/docs/index?identify_key=c0138ffadd90a955c1f0670a56fe348d1d40680b3c89461e09f78ed26785164b\&language=ENGLISH\&doc_id=1771101111730178#item-link-user%20parameters).\
**10.** Défini lorsque la propriété "Smart Mapping" <mark style="color:bleu;">`Plateforme de l’appareil`</mark> ou <mark style="color:bleu;">`context.device.type`</mark> est défini avec <mark style="color:bleu;">`Android`</mark> (insensible à la casse).\
**11.** Requis pour les événements App.\
**12.** Numéro de téléphone au [format E.164](https://www.twilio.com/docs/glossary/what-e164).\
**13.** Voir [Identifiant de langue BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt).\
**14.** Voir [Events API 2.0 - Utilisation limitée des données](https://ads.tiktok.com/marketing_api/docs?id=1771101204435970) pour plus de détails.\
**15.** Valeurs prises en charge : <mark style="color:bleu;">`product`</mark> et <mark style="color:bleu;">`product_group`</mark> . Par défaut : <mark style="color:bleu;">`product`</mark> .\
**16.** Requis pour Video Shopping Ads (VSA).\
**17.** Défini pour les événements Web.\
**18.** Défini dans le <mark style="color:bleu;">`data.0.properties`</mark> propriété. Voir <mark style="color:bleu;">`Propriétés d'événement personnalisées`</mark> dans [Configuration](#configuration).\
**19.** Défini dans le <mark style="color:bleu;">`data.0.user`</mark> propriété. Voir <mark style="color:bleu;">`Propriétés utilisateur personnalisées`</mark> dans [Configuration](#configuration).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/tiktok/tiktok.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.