Pular para o conteúdo principal

Configuração do Script de Mensagem

Esta página documenta os parâmetros do script message para criação de tarefas.

Visão Geral​

O script message envia mensagens diretas automaticamente para usuários no TikTok ou Instagram. Com múltiplos usuários alvo via API, uma tarefa é criada por usuário. Controle o timing com start_time.

Configuração do Script (script_config)​

Parâmetros do script de mensagem:

Parâmetros​

ParâmetroTipoObrigatórioPadrãoDescrição
target_usersstring[]Yes*[]Array de usuários alvo (uma tarefa por usuário)
target_userstringYes*""Nome de usuário único ou múltiplos separados por novas linhas/vírgulas
message_contentstringYes""Conteúdo da mensagem de texto
access_methodstringNo"direct"Método de acesso: direct ou search
observação

target_users ou target_user deve ser fornecido. target_users tem prioridade.

informação

Com múltiplos usuários alvo, a API cria uma tarefa por usuário. 3 usuários + 2 dispositivos = 6 tarefas.

Exemplos​

Enviar mensagem a um usuário​

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"
    }
  }'

Enviar mensagens a múltiplos usuários​

Uma tarefa por usuário:

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."
    }
  }'

Cria 3 tarefas separadas executadas imediatamente.

Agendar mensagens com horário de início​

Use start_time para agendar:

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"
  }'

Enviar via método busca​

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"
    }
  }'

Enviar mensagens por lista de nomes​

Criar tarefas de mensagens para contas específicas:

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!"
    }
  }'

Mensagens em lote em múltiplos dispositivos​

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
  }'

Exemplo Instagram​

A mesma API para 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"
    }
  }'

Resposta​

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

Métodos de Acesso​

Método direto (direct)​

Abre perfil do usuário via URL. Mais rápido e confiável.

Navega para busca e digita o nome. Mais lento mas funciona quando o acesso direto está bloqueado.

Melhores Práticas​

  1. Agende tarefas: Use start_time.

  2. Personalize mensagens: Adapte o conteúdo.

  3. Prefira acesso direto: Mais rápido e confiável.

  4. Respeite limites: Não crie muitas tarefas de uma vez.

Códigos de Erro​

CodeDescription
40001Usuários alvo ou conteúdo de mensagem ausentes
40003Script não suportado via API
40301Plano Pro+ requerido

Veja Também​