Skip to main content
Existem vários tipos de webhooks disponíveis, categorizados por tipo de ação. Por exemplo, uma publicação agendada dispara um webhook de ação scheduled. Consulte a visão geral dos webhooks para mais detalhes. Após registrar uma URL de webhook, você receberá uma requisição POST na sua URL quando um evento ocorrer. A requisição POST incluirá um payload JSON com os detalhes do evento.

Scheduled Action

Você receberá esta notificação de webhook quando uma publicação agendada for processada — seja com sucesso ou falha — e publicada nas redes sociais selecionadas. Por exemplo, se você agendar uma publicação para 12h00 de 1º de agosto de 2026, o webhook será enviado no momento exato em que a publicação for publicada. As notificações de webhook são enviadas apenas para publicações agendadas para o futuro usando o campo scheduleDate no endpoint /post.

Scheduled Event

Você não receberá notificação de webhook para publicações imediatas, pois a API retorna a resposta de sucesso ou falha instantaneamente na resposta JSON. As notificações de webhook são enviadas apenas para publicações agendadas, já que estas são processadas de forma assíncrona e exigem uma notificação separada para informar o status.

Webhook de publicação do TikTok

Ao trabalhar com o TikTok pelo Ayrshare, você pode receber dois webhooks diferentes para uma publicação agendada. Se sua publicação foi agendada em vez de imediata, você receberá primeiro o webhook padrão Scheduled Action. Isso indica que a mídia foi enviada com sucesso ao TikTok para processamento e publicação. Depois, você receberá o webhook subAction: tikTokPublished. Ele é disparado quando o TikTok conclui o processamento da mídia e a torna pública. Este webhook é ativado tanto para publicações imediatas quanto para publicações agendadas. No painel do Ayrshare, este evento aparece como tikTok (pub).
O webhook tikTokPublished não é enviado até que a mídia seja tornada pública. Se a mídia estiver definida como privada, para seguidores ou amigos, o webhook não será enviado.Se você não receber o webhook tikTokPublished e o status da publicação permanecer pending, verifique no aplicativo móvel do TikTok se a mídia foi aceita pelo TikTok.

Social Action

Notificação quando o profile de um usuário vincula ou desvincula uma rede social.

Social Action Event

Um source igual a system significa que o Ayrshare desvinculou automaticamente a conta, como quando a conexão com a rede social não é mais válida. Recomendamos que você avise o usuário para que ele possa continuar publicando. Detalhes da desvinculação aparecem no campo details. Um e-mail também será enviado para o endereço de e-mail da Conta Principal ou para os e-mails alternativos, caso tenham sido configurados. Um source igual a user significa que o usuário iniciou a ação por conta própria, como quando desvinculou manualmente uma conta. Um e-mail não será enviado quando ocorrer uma ação iniciada pelo usuário.

Messages Action

O add-on de Mensagens é necessário para acessar todos os endpoints e webhooks de mensagens. Para Facebook e Instagram, receba notificações quando uma nova mensagem direta chega, é lida ou quando uma reação é criada ou excluída. O WhatsApp atualmente envia uma notificação para a sua URL de webhook registrada apenas quando uma nova mensagem de entrada é armazenada. Webhooks de X/Twitter estão disponíveis como opção para clientes Enterprise. Entre em contato com seu representante de conta para mais informações sobre como se tornar um cliente Enterprise. O WhatsApp não emite webhooks de reação ou de status de entrega para a sua URL registrada hoje. Mensagens de saída armazenadas podem ter um valor de status sent, delivered, read ou failed — consulte WhatsApp Message Status abaixo.

Cobertura de standby para Páginas do Facebook com múltiplos apps

O Ayrshare se inscreve no campo de webhook standby do Facebook, além dos campos padrão de mensagens. Isso significa que eventos do Messenger são entregues ao seu webhook mesmo quando outro app na mesma Página do Facebook está com controle da thread no momento — por exemplo, quando uma plataforma de chatbot está definida como o receptor principal da sua Página ou quando a Page Inbox do Meta está tratando ativamente uma conversa. Não há mudança de schema para esses eventos. Eles chegam como os mesmos payloads de messageCreated / messageRead / reactionCreated / messageEdited documentados nas seções abaixo. Duas coisas para se atentar em Páginas com um app do Messenger concorrente instalado:
  • O volume de mensagens de entrada pode aumentar em comparação com o comportamento anterior, quando eventos de standby eram descartados silenciosamente antes de haver assinatura. O novo tráfego representa mensagens que sua Página recebeu e que estavam sendo tratadas pelo outro app.
  • Você pode receber eventos messageCreated com type: "sent" que não correspondem a mensagens enviadas por você através do Ayrshare. Estes são ecos de mensagens enviadas pelo outro app do Messenger na sua Página (o Meta entrega uma cópia de cada envio para cada app assinado). Se sua integração reconcilia o tráfego de saída com o seu próprio histórico de envios, você pode usar esse histórico para distinguir seus envios dos envios de um app concorrente.
Para Páginas apenas com o Ayrshare instalado (sem app do Messenger concorrente), a única mudança observável é o novo Message Edit Event — todo o resto se comporta de forma idêntica ao anterior.

New Message Events

Notificação quando uma nova mensagem é enviada ou recebida.

Message Read Event

Notificação quando uma mensagem é lida pelo destinatário.
Quando uma mensagem é lida no Instagram, o payload do webhook inclui um campo mid que identifica de forma única qual mensagem específica foi lida. Para mensagens do Facebook, as leituras de mensagem são rastreadas em nível de conversa usando o conversationId. Quando ocorre um evento de leitura, todas as mensagens dessa conversa com timestamps anteriores ao timestamp created (ou read) devem ser consideradas lidas pelo usuário.

Reaction Created and Deleted Events

Notificação quando uma reação, como uma curtida, é criada ou excluída em uma mensagem.

Message Edit Event

Notificação quando um usuário edita uma mensagem que enviou anteriormente. Disponível para mensagens diretas do Facebook e Instagram. O campo messageEdit.mid corresponde ao id do evento messageCreated original, de modo que os consumidores podem correlacionar a edição com a mensagem original. O campo messageEdit.text traz o novo texto editado da mensagem.

WhatsApp Message Status

O WhatsApp rastreia o estado de entrega por mensagem em mensagens de saída armazenadas usando um único campo status: sent, delivered, read ou failed. Essas atualizações não são entregues atualmente à sua URL de webhook registrada como eventos separados. Se você precisar do estado de entrega em tempo real, entre em contato com seu representante de conta Ayrshare.

Batch Action

Notificação quando um batch conclui o processamento e o arquivo está disponível, como em obter todos os user profiles. Você pode acessar o arquivo com a URL pré-assinada no campo url.

Batch Event

Feed Action

Notificação quando um novo item de feed RSS é encontrado para feeds RSS registrados. Observação: se o webhook estiver ativo, novos itens de RSS não serão automaticamente publicados nas redes sociais.

Feed Event

Mentions Action

Notificação quando sua conta conectada é mencionada. Disponível para Facebook e Instagram.
Para o Instagram, registrar o webhook mentions é tudo o que é necessário para receber eventos de menção. O add-on de Mensagens, a habilitação de mensagens e revincular a conta social não são necessários.
O Ayrshare retransmite o payload nativo de menção do Meta sem alterações, adicionando apenas os campos padrão de envelope (action, refId, hookId, url e timeStamp com a Segurança de Webhook) e subAction. O exemplo abaixo é o formato do Instagram: media_id, além de comment_id quando a menção está em um comentário. Menções do Os eventos de menção de Páginas do Facebook não são entregues atualmente — a Ayrshare os confirma para a Meta e não os encaminha ao seu webhook. Hoje apenas as menções do Instagram são entregues.

Mention Event (Instagram)

Comments Action

Notificação quando um comentário é criado no seu conteúdo conectado. Disponível para Facebook e Instagram.
Para o Instagram, registrar o webhook comments é tudo o que é necessário para receber eventos de comentário. O add-on de Mensagens, a habilitação de mensagens e revincular a conta social não são necessários.
O Ayrshare retransmite o payload nativo de comentário do Meta sem alterações, adicionando apenas os campos padrão de envelope (action, refId, hookId, url e timeStamp com a Segurança de Webhook) e subAction. O exemplo abaixo é o formato do Instagram. Comentários do Facebook chegam como uma mudança de feed de uma Página, com nomes de campos diferentes (por exemplo, comment_id, post_id, message e from.name); consulte a referência de webhooks do Meta para o conjunto de campos do Facebook.

Comment Event (Instagram)

Automations Action

Notificação quando uma automação dispara uma ação de webhook para um usuário, como um gatilho de resposta automática de comentário ou DM.

Automation Event

Demo Action

Notificação para eventos do ciclo de vida do Demo User Profile. Os Demo User Profiles estão disponíveis no Enterprise plan; entre em contato conosco se quiser saber mais. Dois tipos de evento são enviados na ação demo, diferenciados pelo campo type:
  • upgradeWarning — enviado dois dias antes de um Demo User Profile ser convertido automaticamente em um User Profile padrão, para que você possa avisar o seu usuário a continuar ou remover o profile.
  • upgrade — enviado quando a conversão acontece.

Demo Upgrade Warning Event

Demo Upgrade Event