Webhooks da Meta

Webhooks para contas de anúncios

Os webhooks para contas de anúncios permitem que você receba notificações em tempo real sobre determinadas alterações nos anúncios.

Para configurar webhooks em contas de anúncios, siga estas etapas:

  1. Configure o ponto de extremidade e defina os webhooks.
  2. Inscreva seu app na sua conta de anúncios.

Configurar o ponto de extremidade e os webhooks

Siga nosso guia de introdução para criar o ponto de extremidade e configurar os webhooks. Ao configurar seus webhooks, escolha Ad Account.

No momento, você pode receber notificações em tempo real sobre alterações de status de objetos do anúncio para WITH_ISSUES e IN_PROCESS. Faça a inscrição para um ou mais campos abaixo:

Campo Descrição

with_issues_ad_objects

Envia uma notificação a você quando uma campanha, conjunto de anúncios ou anúncio na conta de anúncios recebe o status WITH_ISSUES.

in_process_ad_objects

Envia uma notificação a você quando uma campanha, conjunto de anúncios ou anúncio sai do status IN_PROCESS. Consulte o artigo sobre pós-processamento para saber mais.

ad_recommendations

Envia uma notificação a você quando recomendações são geradas para seus anúncios.

creative_fatigue

Envia uma notificação a você quando seu anúncio entra ou sai do estado de fadiga. Fornece informações mais detalhadas com diferentes níveis de fadiga, como Baixo, Médio e Alto. Apenas anúncios configurados como ACTIVE serão notificados.

product_set_issue

Notifica você quando um problema no conjunto de produtos afeta seus anúncios.

Inscrever seu app

Você precisa inscrever seu app para receber notificações de webhooks sobre a conta de anúncios. O app deve ter permissão de edição na conta de anúncios para concluir esta etapa. A permissão ads_management também é necessária.

Para inscrever seu app, envie uma solicitação POST de subscribed_apps para a conta de anúncios:

curl -i -X POST \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps?app_id=<APP_ID>"

Se o processo for bem-sucedido, você verá a seguinte resposta:

{"success": "true"}

Para ver quais apps estão inscritos na sua conta de anúncios, envie uma solicitação GET:

curl -i -X GET \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps"

Se o processo for bem-sucedido, você verá a seguinte resposta:

{
  "data": [
  { 
    "name": "<APP_NAME>", 
    "id": "<APP_ID>" 
  } ]
}

Para remover a inscrição de um app, envie uma solicitação DELETE:

Se o processo for bem-sucedido, você verá a seguinte resposta:

{"success": "true"}

Fazer a inscrição com o Explorador da Graph API

Também é possível inscrever um app usando o Explorador da Graph API.

Substitua a consulta me?fields=id,name por act_AD_ACCOUNT_ID/subscribed_apps. Isso inscreverá o app usado para enviar a solicitação POST no Explorador da Graph API. Como opção, você pode inscrever outro app ao especificar subscribed_apps como um parâmetro de entrada com o ID do app.

Para fazer a inscrição, seu app deve ter permissão para editar a conta de anúncios.

[
  {
    "object": "ad_account",
    "entry": [
      {
        "id": "0",
        "time": 1568132516,
        "changes": [
          {
            "field": "with_issues_ad_objects",
            "value": {
              "id": "111111111111",
              "level": "AD",
              "error_code": "567",
              "error_summary": "error summary",
              "error_message": "error message"
            }
          }
        ]
      }
    ]
  }
]