Aller au contenu principal

Configuration du Script Message

Cette page documente les paramètres du script message pour la création de tâches.

Aperçu​

Le script message envoie automatiquement des messages directs aux utilisateurs sur TikTok ou Instagram. Avec plusieurs utilisateurs cibles via l'API, une tâche est créée par utilisateur. Contrôlez le timing avec start_time.

Configuration du Script (script_config)​

Paramètres de configuration du script message:

Paramètres​

ParamètreTypeRequisDéfautDescription
target_usersstring[]Yes*[]Array d'utilisateurs cibles (une tâche par utilisateur)
target_userstringYes*""Nom d'utilisateur unique ou plusieurs séparés par retours/virgules
message_contentstringYes""Contenu du message texte
access_methodstringNo"direct"Méthode d'accès: direct ou search
remarque

target_users ou target_user doit être fourni. target_users a la priorité.

info

Avec plusieurs utilisateurs cibles, l'API crée une tâche par utilisateur. 3 utilisateurs + 2 appareils = 6 tâches.

Exemples​

Envoyer un message à un utilisateur​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@username_to_message"],
      "message_content": "Hello! Check out our latest content.",
      "access_method": "direct"
    }
  }'

Envoyer des messages à plusieurs utilisateurs​

Une tâche par utilisateur:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2", "@user3"],
      "message_content": "Hi! We have an exclusive offer for you."
    }
  }'

Crée 3 tâches séparées exécutées immédiatement.

Planifier des messages avec l'heure de début​

Utilisez start_time pour planifier:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@user1", "@user2"],
      "message_content": "Scheduled greeting!"
    },
    "start_time": "14:30"
  }'

Envoyer via la méthode recherche​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_users": ["username1", "username2"],
      "message_content": "Hello from TikMatrix!",
      "access_method": "search"
    }
  }'

Envoyer des messages par liste d'usernames​

Créer des tâches de messages pour des comptes spécifiques:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@my_account1", "@my_account2"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@target_user"],
      "message_content": "Hi there!"
    }
  }'

Messages en lot sur plusieurs appareils​

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_1", "device_2", "device_3"],
    "script_name": "message",
    "script_config": {
      "target_users": ["@influencer_account"],
      "message_content": "Love your content! Let's collaborate."
    },
    "enable_multi_account": true
  }'

Exemple Instagram​

La même API pour Instagram:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "message",
    "script_config": {
      "target_user": "instagram_username",
      "message_content": "Hey! Loved your post"
    }
  }'

Réponse​

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [501, 502, 503],
    "created_count": 3
  }
}

Méthodes d'Accès​

Méthode directe (direct)​

Ouvre le profil utilisateur via URL. Plus rapide et fiable.

Navigue vers la recherche et tape le nom. Plus lent mais fonctionne quand l'accès direct est bloqué.

Bonnes Pratiques​

  1. Planifier les tâches: Utilisez start_time.

  2. Personnaliser les messages: Adaptez le contenu.

  3. Préférer l'accès direct: Plus rapide et fiable.

  4. Respecter les limites: Ne créez pas trop de tâches à la fois.

Codes d'Erreur​

CodeDescription
40001Utilisateurs cibles ou contenu manquant
40003Script non pris en charge via l'API
40301L'accès API nécessite un plan Pro+

Voir Aussi​