Pular para o conteúdo principal

Configuração do Script de Mensagem

message não pode ser criado

A criação de tarefas rejeita message: o binário de scripts não tem tratador para ele em nenhuma das plataformas, então toda tarefa desse tipo falhava no dispositivo com "Unknown script". Os parâmetros abaixo ficam apenas como referência. Para enviar mensagens diretas hoje, use Super Marketing.

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​