Configuração do Script Unfollow
Esta página documenta os parâmetros de configuração para o script unfollow usado na criação de tarefas.
Visão Geral
O script unfollow é usado para deixar de seguir automaticamente usuários no TikTok ou Instagram. Quando você fornece múltiplos usuários alvo via API, uma tarefa é criada por usuário alvo. Você pode controlar quando cada tarefa é executada usando o parâmetro start_time.
Configuração do Script (script_config)
O objeto script_config contém os parâmetros para o script unfollow. Abaixo estão os parâmetros disponíveis:
Parâmetros
| Parâmetro | Tipo | Obrigatório | Padrão | Descrição |
|---|---|---|---|---|
| target_users | string[] | Sim* | [] | Array de nomes de usuário alvo para deixar de seguir (uma tarefa por usuário) |
| target_user | string | Sim* | "" | Nome de usuário alvo único ou múltiplos nomes de usuário separados por quebras de linha/vírgulas |
| access_method | string | Não | "direct" | Como navegar até o perfil do usuário: direct (via URL) ou search |
Ou o array target_users ou a string target_user deve ser fornecida. Se ambos forem fornecidos, target_users tem prioridade.
Quando múltiplos usuários alvo são fornecidos, a API cria uma tarefa por usuário alvo. Por exemplo, se você especificar 3 usuários alvo e 2 dispositivos, 6 tarefas serão criadas. Use o parâmetro start_time para controlar quando as tarefas começam a executar.
Exemplos
Deixar de Seguir Usuário Único
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "unfollow",
"script_config": {
"target_users": ["@username_to_unfollow"],
"access_method": "direct"
}
}'
Deixar de Seguir Múltiplos Usuários
Ao deixar de seguir múltiplos usuários, uma tarefa é criada por usuário:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "unfollow",
"script_config": {
"target_users": ["@user1", "@user2", "@user3"],
"access_method": "direct"
}
}'
Isso cria 3 tarefas separadas que são executadas imediatamente.
Agendar Tarefas com Horário de Início
Use start_time para agendar quando as tarefas devem começar:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "unfollow",
"script_config": {
"target_users": ["@user1", "@user2"],
"access_method": "direct"
},
"start_time": "14:30"
}'
Deixar de Seguir Usuários via Método de Busca
Use o método de busca quando o acesso direto por URL não estiver funcionando:
curl -X POST http://localhost:50809/api/v1/task \
-H "Content-Type: application/json" \
-d '{
"serials": ["device_serial_1"],
"script_name": "unfollow",
"script_config": {
"target_users": ["username1", "username2"],
"access_method": "search"
}
}'
Deixar de Seguir 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": "unfollow",
"script_config": {
"target_users": ["@old_account"],
"access_method": "direct"
},
"enable_multi_account": true
}'
Resposta
{
"code": 0,
"message": "success",
"data": {
"task_ids": [201, 202, 203],
"created_count": 3
}
}
Métodos de Acesso
Método Direto (direct)
- Abre o perfil do usuário via URL:
tiktok.com/@usernameouinstagram.com/username - Mais rápido e confiável
- Recomendado para a maioria dos casos de uso
Método de Busca (search)
- Navega até a busca, digita o nome de usuário, clica no resultado
- Mais lento, mas funciona quando o acesso direto por URL está bloqueado
- Pode ser menos preciso se existirem múltiplos nomes de usuário semelhantes
Melhores Práticas
-
Use start_time para agendamento: Use o parâmetro
start_timepara agendar quando as tarefas devem executar (formato: "HH:MM"). -
Prefira acesso direto: O método de acesso
directé mais rápido e confiável que osearch. -
Processe em lotes com sabedoria: Não deixe de seguir muitos usuários de uma só vez. O sistema cria uma tarefa por usuário alvo, então listas grandes resultam em muitas tarefas.
Veja Também
- API de Gerenciamento de Tarefas - Criar, listar e gerenciar tarefas
- Configuração do Script Post - Configurar parâmetros do script post
- Configuração do Script Follow - Configurar parâmetros do script follow