O recurso de Webhook permite que publishers e parceiros integrem seus sistemas próprios ou plataformas de auditoria externa diretamente com a adMooH. Ao ativar esta função, nosso motor de entrega (adServer) enviará notificações automáticas contendo os dados estruturados de cada exibição válida (inserção) confirmada pelas telas.
O Webhook funciona disparando lotes de logs de exibição (Proof of Play) para uma URL externa configurada por você. A comunicação é feita utilizando o método HTTP POST seguro.
1. Configurando a Integração no Painel
Para ativar o recebimento automático em seu sistema, acesse o menu de integrações do dispositivo e preencha os parâmetros conforme a interface de ativação:
URL: O endereço de endpoint estruturado pelo seu time de desenvolvimento para receber as requisições (ex:
[https://api.seudominio.com/v1/webhook](https://api.seudominio.com/v1/webhook)).Nome do Cabeçalho: O parâmetro de identificação do cabeçalho HTTP (padrão recomendado:
Authorization).Valor do Cabeçalho: O token secreto ou chave Bearer gerada pelo seu sistema para autenticar e validar que a requisição partiu dos servidores da adMooH (ex:
Bearer CHAVE_SECRETA_AQUI).
2. Estrutura Técnica de Envio (Exemplo cURL)
O seu servidor receberá chamadas estruturadas no padrão JSON. Abaixo está o exemplo de requisição no modelo cURL para guiar a sua equipe de desenvolvimento:
3. Dicionário de Dados do Payload (Campos)
Cada requisição envia uma lista de objetos contendo os logs detalhados das exibições. Abaixo está a descrição técnica de cada variável entregue:
| Campo (JSON Key) | Tipo de Dado | Descrição |
deviceId | Número (Integer) | ID do Dispositivo (tela) cadastrado na plataforma adMooH. |
impact | Decimal (Float) | Métrica de Impactos/Impressões gerados por aquela exibição específica (audiência calculada pelo multiplier). |
gridId | Número (Integer) | Identificador da Grade de programação vinculada ao player. |
blockId | Número (Integer) | Identificador do Bloco da grade em que o conteúdo foi veiculado. |
contentID | Número (Integer) | ID exclusivo da mídia/conteúdo exibido. |
printedAt | Texto (ISO 8601) | Carimbo exato de data e hora em que a exibição ocorreu no hardware. |
durationInseconds | Número (Integer) | Tempo total de veiculação do conteúdo na tela em segundos. |
4. Lógica de Envio e Política de Retentativas (Importante)
Para garantir a estabilidade dos servidores e a integridade dos dados, a adMooH adota a seguinte política de entrega de pacotes:
Intervalo de Envio: O sistema agrupa os logs e realiza os disparos em lotes a cada 5 minutos.
Primeira Retentativa: Caso o seu servidor responda com erro (qualquer status diferente de HTTP
200 OK) ou fique fora do ar, o sistema aguarda 5 minutos e realiza uma nova tentativa de envio.Segunda Retentativa (Última): Se o erro persistir na segunda tentativa, o sistema aguardará mais 5 minutos e tentará uma terceira e última vez.
Bloqueio de Segurança: Se a entrega falhar em todas as 3 tentativas, o envio do Webhook será pausado automaticamente para evitar sobrecarga em ambas as plataformas.
⚠️ O que fazer se o Webhook for pausado? Caso o fluxo seja interrompido por falha persistente do seu servidor receptor, o envio não será retomado de forma automática. Após corrigir a instabilidade do seu lado, entre em contato diretamente com a equipe de desenvolvimento da adMooH para solicitar a reativação da fila através dos e-mails:
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo