> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/action-management/event-notifications-and-postbacks/enable-action-inquiry-event-notification-postbacks-as-a-partner.md).

# Ativar postbacks de notificação de evento de consulta de ação como parceiro

Se quiser receber notificações em tempo real sempre que [consultas de ação](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/action-management/action-inquiries/manage-submitted-action-inquiries-as-a-partner.md) forem criadas ou resolvidas, você poderá configurar notificações de eventos. Para obter mais informações sobre o que são notificações de eventos, como funcionam os postbacks de consultas de ação e muito mais, consulte [Postbacks de notificação de eventos de consultas de ação](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/action-management/event-notifications-and-postbacks/action-life-cycle-event-notification-faqs.md).

## Configurar postbacks de consultas de ação

{% hint style="success" %}
Este recurso está disponível apenas para edições ou complementos específicos do impact.com. [Entre em contato](https://app.impact.com/support/portal.ihtml?createTicket=true) para fazer upgrade da sua conta e obter acesso!
{% endhint %}

Os postbacks de consultas de ação atualizam você sempre que uma consulta de ação é aberta ou fechada por um usuário da conta impact.com em sua conta. Para configurar postbacks de consultas de ação:

1. Na barra de navegação superior, selecione ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FhyR4iWDS0fO9ZcKFGf82%2FUser%20profile.svg?alt=media\&token=281d8f1b-b9c5-4208-a0a2-a078f54e0eb6) **\[Perfil do usuário] → Configurações**.
2. Em *Técnico*, à esquerda, selecione **Notificações de eventos**.
3. Passe o cursor sobre o campo *Eventos de consultas de ação* e selecione ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FZMLVDhHLGefqRDHaIWTm%2FEdit.svg?alt=media\&token=1f1168ae-5bd3-456c-a366-904d0ecf00cb) **\[Editar]**.
4. Insira o URL do seu servidor. Este é o URL para o qual a impact.com enviará os postbacks.
5. Selecione seu método HTTP preferido.
   * Se você selecionar **Post**, será necessário inserir o corpo da solicitação. Abaixo está um exemplo de como você pode mapear cada ponto de dados para um formato JSON. As chaves em cada par de chave-valor devem ser originadas da configuração do seu próprio sistema, e os valores serão o ponto de dados correspondente escolhido que a impact.com fornece e deverão ser inseridos entre chaves `{ }`.

     <div data-with-frame="true"><figure><img src="https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FM4ae4IUfR5fkv8MM5K0E%2FScreenshot%202026-05-23%20at%2013.22.07.png?alt=media&amp;token=986f854b-9142-480e-9ec9-0afe6e57c913" alt="" width="563"><figcaption></figcaption></figure></div>
   * Veja alguns dos [parâmetros de corpo disponíveis](https://docs.google.com/spreadsheets/d/1omPZ6CG0guvMPh6EdbYg7BczHqJOrtuZ2zXnTtgfhrY/edit?usp=sharing).
   * Não encontra um valor necessário? Entre em contato com seu gerente de conta de publisher (ou [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true)).
6. Selecione o **Formato do corpo** que corresponde à sua configuração na *Etapa 5*.
7. Selecione **Eventos de consultas de ação** ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-500f241687470b7f2c6cf43ec949c2463692cd19%2F0323174d38f3b23e95ed28b6734e6af44b570eec2eecb0ea9f2e0f064962b5fb.svg?alt=media) Estas configurações são opcionais.
   * Insira um **Cabeçalho HTTP** como uma forma de transmitir informações adicionais entre você e o servidor.
   * Insira um **Atraso mínimo** entre o momento em que um evento ocorre e o momento em que o postback é gerado e enviado ao seu sistema.
   * Insira um limite de taxa para o número máximo de **Solicitações máximas** que a impact.com pode fazer ao seu sistema por segundo.
   * Insira como deseja que seja a **Resposta de sucesso** a um postback.
   * Insira como deseja que seja a **Resposta de erro** a um postback.
8. Selecione **Salvar**.

Agora que você configurou os postbacks de consultas de ação, seu sistema deverá começar a receber postbacks sempre que uma consulta for criada por sua conta ou resolvida por uma marca parceira. Para saber como testar sua nova configuração de postback, consulte a *Testar um postback de consulta de ação* seção abaixo.

## Testar um postback de consulta de ação

Depois de configurar os postbacks de consultas de ação, você deverá testar sua configuração. Certifique-se de avisar sua marca parceira que testará sua configuração de postback.

1. No menu de navegação superior, selecione **Gerenciar →** [**Criativos da marca**](https://app.impact.com/secure/mediapartner/ads/searchAdsDirectoryMP.ihtml#adType=all).
2. Selecione um recurso e, em seguida, no painel deslizante, selecione **Obter link de rastreamento**. Certifique-se de que haja valores nos campos *Sub ID* e *ID compartilhado* :
   * ![](https://1502018143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FEv341AdIiPndQSb7uGMI%2FToggle%20on.svg?alt=media\&token=4ae8972d-c510-4ee2-adc5-e7170981650b) **\[Ativar] Parâmetros de rastreamento**, insira pelo menos uma palavra em cada *Sub ID* e *ID compartilhado* campo e selecione **Salvar**.
3. Selecione **Copiar link de rastreamento**.
4. **Cole** o link em uma nova janela do navegador e pesquise.
5. Conclua a ação.
   * Essa ação será revertida posteriormente.
6. Após cerca de 15 minutos, encontre a ação na tela [Ações pendentes](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/action-management/where-can-i-see-my-pending-actions-as-a-partner.md) . Você precisará de algumas informações para gerar uma consulta de ação no aplicativo:
   * A **marca** associada à sua ação de teste.
   * O **ID do pedido**.
   * O **Valor da venda**.
   * O **Data da transação**.
7. Crie uma nova consulta de ação na impact.com. Na seção *Notas* , mencione que esta é uma consulta de teste.
   * Saiba como [criar uma consulta pela interface do usuário](/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/action-management/action-inquiries/manage-submitted-action-inquiries-as-a-partner.md).
   * Depois disso, você deverá receber um postback informando que uma consulta de ação foi criada. Se você vir a nova consulta na tela *Consultas* mas ainda não tiver recebido um postback, verifique novamente sua configuração de postback.
8. Forneça à sua marca parceira o **ID do pedido** associado à consulta e peça que ela **Recuse** a consulta.
   * Quando a marca recusar a consulta, você deverá receber outro postback informando sobre a resolução da consulta. Se você vir a atualização da consulta na *Consultas* mas ainda não tiver recebido um postback, verifique novamente sua configuração de postback.

{% hint style="warning" %}
**Aviso:** Se não conseguir encontrar nenhum problema com sua configuração de postback, mas ainda não estiver recebendo postbacks, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true). Podemos verificar se os postbacks estão sendo gerados, qual é o código de resposta deles, bem como o corpo de cada postback. Essas informações podem ajudar você a depurar sua configuração com sucesso.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/partner/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/action-management/event-notifications-and-postbacks/enable-action-inquiry-event-notification-postbacks-as-a-partner.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
