Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Eventos do webhook de comentários do TikTok

A API for Business do TikTok envia um webhook comment.update no prazo de cinco minutos após um comentário ou resposta ser criado, eliminado, ocultado, definido como apenas para amigos ou tornado público nas publicações de fotos e nos vídeos públicos de uma conta. Cada evento identifica o comentário, a publicação, a ação, o identificador do autor e o texto, e é assinado com um cabeçalho Tiktok-Signature.

O easyCoexistence reencaminha cada evento de comentário do TikTok da conta para o seu endpoint HTTPS à medida que chega, assinado com um segredo dessa conta e sem cópia guardada.

5 min

Tempo dentro do qual comment.update é disparado após um comentário ou resposta ser criado, eliminado ou mudar de visibilidade.

72 hours

Tempo durante o qual o TikTok repete uma entrega à qual o callback não respondeu com HTTP 200, aumentando os intervalos de forma exponencial.

comment.list

Âmbito que a conta tem de ter concedido, e manter válido, para que os seus eventos comment.update sejam enviados.

At least once

Promessa de entrega do TikTok, pelo que o mesmo evento pode chegar mais de uma vez e o tratamento deve ser idempotente.

O que reporta o comment.update?

Alterações aos comentários das publicações de fotos e dos vídeos públicos da conta, quer tenham sido publicados através da API quer na aplicação do TikTok. O comment_action indica o que aconteceu:

  • insert: foi criado um comentário ou uma resposta.
  • delete: foi eliminado.
  • set_to_hidden: foi ocultado, por um utilizador ou através de moderação.
  • set_to_friends_only: passou a ser visível apenas para amigos.
  • set_to_public: passou de oculto ou só para amigos a visível para toda a gente.

O que traz um evento?

O TikTok envia um JSON com client_key, event, create_time e user_openid, que é o ID da conta, e content, uma string JSON serializada. Dentro de content: comment_id e video_id, parent_comment_id nas respostas, comment_type (comment ou reply), comment_action, um carimbo temporal, o unique_identifier do autor e o texto. Os IDs são números JSON demasiado grandes para um double os guardar com exatidão, pelo que devem ser lidos a partir da string original.

Como chegam os eventos ao seu endpoint?

O TikTok envia webhooks para a aplicação de programador, através de um único URL de callback para toda a aplicação. O easyCoexistence recebe-os e reencaminha cada comment.update de uma conta ligada para o endpoint HTTPS que definiu para ela, uma vez, à medida que chega, assinado com o segredo próprio dessa conta. Defina o endpoint com set_social_webhook_destination a partir do Claude ou do ChatGPT, ou com a Partner API através de PUT /channels/:id/webhook; o segredo é mostrado uma só vez, e um URL null desliga o reencaminhamento.

Como é um evento reencaminhado?

Um POST com a plataforma, o account_id que list_social_accounts devolve para a ligação, o external_id da conta, que é o open_id do TikTok, e entry: o nome do evento, create_time e content, com content já processado e os IDs convertidos em strings para que nenhum seja arredondado.

A forwarded comment.update event
{
  "platform": "tiktok",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<TIKTOK_OPEN_ID>",
  "entry": {
    "event": "comment.update",
    "create_time": 1793318400,
    "content": {
      "comment_id": "<COMMENT_ID>",
      "video_id": "<VIDEO_ID>",
      "parent_comment_id": null,
      "comment_type": "comment",
      "comment_action": "insert",
      "timestamp": 1793318399000,
      "unique_identifier": "<UNIQUE_IDENTIFIER>",
      "text": "<COMMENT_TEXT>"
    }
  }
}

Como verifica um evento reencaminhado?

Cada entrega reencaminhada traz um cabeçalho X-EC-Signature, t=<unix>,v1=<hex>, em que v1 é um HMAC-SHA256 do carimbo temporal, de um ponto e do corpo bruto, com a chave do segredo de assinatura da conta. Recalcule-o sobre o corpo exatamente como chegou, compare os dois em tempo constante e recuse um carimbo com mais de 5 minutos de idade.

A entrega é repetida?

Não pelo easyCoexistence. Cada evento é reencaminhado uma só vez, em memória, sem cópia guardada para repetir; o reencaminhamento aguarda 8 segundos por uma resposta e não segue redirecionamentos. A montante, o TikTok repete as suas próprias entregas durante até 72 horas e garante pelo menos uma, pelo que o mesmo evento pode chegar-lhe duas vezes: deduplique pelo comment_id em conjunto com o comment_action.

Erros comuns

  • Converter os IDs em números. O comment_id e o video_id são maiores do que um double consegue guardar com exatidão; o easyCoexistence reencaminha-os como strings, pelo que deve mantê-los assim.
  • Calcular a assinatura sobre uma cópia processada do corpo. O HMAC cobre o corpo bruto tal como foi entregue, e voltar a serializá-lo impede que a assinatura coincida.
  • Tratar um evento repetido duas vezes. O TikTok entrega pelo menos uma vez, pelo que deve usar comment_id e comment_action como chave antes de agir.
  • Apontar o destino para um endereço que redireciona. O reencaminhamento não segue redirecionamentos, pelo que deve indicar o URL HTTPS final.
Fazer isto com a EasyCoexistence

Ative-o com set_social_webhook_destination a partir do Claude ou do ChatGPT, ou com a Partner API. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias grátis.

Perguntas frequentes

Que eventos de webhook do TikTok são reencaminhados?

comment.update, para comentários e respostas nas publicações da conta ligada: criados, eliminados, ocultados, definidos como apenas para amigos ou tornados públicos.

Os eventos de publicação do TikTok também são reencaminhados?

Não. O reencaminhamento transporta eventos de comentários; acompanhe a publicação com get_tiktok_publish_status.

Com que rapidez chega um evento de comentário do TikTok?

O TikTok envia comment.update no prazo de cinco minutos após a alteração, e o easyCoexistence reencaminha-o assim que chega.

Um evento de comentário do TikTok inclui o texto?

O TikTok documenta um campo text no content do evento, a par dos IDs do comentário e da publicação, da ação e do unique_identifier do autor.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em