API de Marketing

Teste e solução de problemas

Use esta API para criar e excluir cadastros de teste.

Como usar a ferramenta de teste

Use esta ferramenta para criar e excluir cadastros de teste dos seus formulários. No entanto, não é possível usar a ferramenta no modo de desenvolvimento.

Você pode criar um cadastro de teste por formulário. É preciso excluir um cadastro existente para criar um novo.

Depurar a integração da atualização em tempo real

Use esta ferramenta para testar se a integração com os Webhooks do Facebook foi bem-sucedida. Consulte as etapas a seguir se quiser usar a ferramenta para depurar a integração.

Os cadastros criados com a ferramenta são cadastros orgânicos sem associação a anúncios. É possível criar somente um cadastro por formulário. Por isso, se quiser recriar um cadastro no mesmo formulário, clique em Excluir cadastro primeiro e, depois, crie-o novamente.

  1. Acesse a ferramenta de teste.

    2. O menu suspenso lista todas as páginas a que você tem acesso de anunciante.

  2. Selecione uma página no menu suspenso.

  3. Em Formulário, selecione a opção que será usada para criar um cadastro.

  4. Clique em Criar cadastro para iniciar o processo de criação. Por padrão, o cadastro criado contém dados fictícios.

  5. Clique em Ver prévia do Formulário para personalizar os dados enviados.

  6. Digite os dados desejados no nível do formulário para criar um cadastro com o conteúdo personalizado.

  7. Depois de criar o cadastro, você verá o botão Acompanhar status.

  8. Clique em Acompanhar status para ver o status dos cadastros. Demora alguns segundos para a atualização em tempo real ser disparada no seu ponto de extremidade. Enquanto isso, você verá a atualização com status pendente. Clique em Acompanhar status até você ver a mudança.

Ao enviar o cadastro para o seu ponto de extremidade, o campo de status será alterado. Se a atualização em tempo real for disparada, o status será definido como sucesso.

Nesse caso, você também verá a carga na tabela. A carga apresentada é uma cópia do que o Facebook envia ao ponto de extremidade; portanto, você deve visualizar o conteúdo e gerenciar o JSON. Se houver problemas durante o envio da atualização, o status será alterado para falha. Nesse caso, a coluna error_code exibirá informações sobre o motivo da falha.

Teste de cadastro

Depois de configurar webhooks para o seu app, é possível testar os cadastros usando o botão Testar. O botão aparece no painel de webhooks do app.

Criar cadastros de teste

Para criar cadastros de teste, envie uma solicitação POST a /{FORM_ID}/test_leads.

Para que a solicitação seja bem-sucedida, é necessário atender aos seguintes requisitos:

  • Não devem existir outros cadastros de teste para o formulário de anúncio de cadastro.
  • Você deve ter a função de Advertiser ou superior na página de criação do formulário.
curl \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

É possível personalizar o conteúdo do cadastro ao passar os seguintes parâmetros:

  • field_data: um parâmetro de vetor com pares de name e values.
  • custom_disclaimer_responses: um parâmetro de vetor com pares de checkbox_key e is_checked.
curl \
  -F "field_data=[{'name': 'favorite_color?', 'values': ['yellow']}, {'name': 'email', 'values': ['test@test.com']}]" \
  -F "custom_disclaimer_responses=[{'checkbox_key': 'my_checkbox', 'is_checked': true}]" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Os cadastros criados a partir das chamadas acima são fictícios e, portanto, não estão associados a nenhum anúncio.

Ler cadastros de teste

É possível ler os cadastros de teste associados ao formulário de anúncios de cadastro fazendo uma chamada GET para o ponto de extremidade {FORM_ID}/test_leads.

curl \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Excluir cadastros de teste

Se você quiser excluir e reenviar um cadastro durante o teste da sua integração, faça a seguinte chamada de API:

curl -X DELETE \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<LEAD_ID>"

Vale lembrar que apenas o proprietário pode excluir um cadastro.