Como configurar notificações do AdMate e webhooks do RevenueCat

As notificações do AdMate podem adicionar contexto aos eventos do RevenueCat, mas o caminho das notificações é separado da conexão do painel. O app consulta os projetos com as credenciais configuradas pelo usuário; a API do AdMate recebe os webhooks configurados e usa um contexto temporário do dispositivo para criar a notificação adequada.

Manter essas responsabilidades separadas é essencial para a segurança e para a solução de problemas.

AdMate

Todos os seus ganhos num único painel

Acompanhe AdMob, AdSense, RevenueCat e App Store Connect em várias contas com filtros por app, plataforma e país

Monitorize ganhos, cliques, eCPM, subscrições, instalações e pagamentos no iPhone, iPad, Mac e Apple Watch

Duas configurações, dois propósitos

Conexão do painel

A conta do RevenueCat no AdMate permite que o app leia os projetos e as métricas disponíveis para a autorização configurada.

Entrega de webhooks

O RevenueCat envia eventos para o endpoint de webhook da API do AdMate. A API usa o contexto registrado do dispositivo, como projeto, app, idioma e moeda, para preparar as notificações compatíveis.

Adicionar uma chave no painel não cria automaticamente o webhook no provedor. Criar o webhook não autoriza o painel do app.

Prepare o contexto do app

Conecte e valide a conta do RevenueCat no AdMate.
Selecione os projetos e aplicativos desejados.
Abra a configuração de webhook ou de notificações oferecida pelo app.
Sincronize o contexto do dispositivo solicitado pelo fluxo.
Confirme o idioma, a moeda e os nomes dos projetos.
Permita notificações no sistema operacional.

O contexto da API tem duração limitada e deve ser atualizado pelo fluxo compatível do app. Ele não é um banco de dados financeiro permanente.

Configure o RevenueCat

Use a configuração de webhooks do RevenueCat para adicionar o endpoint e as informações de autorização mostradas pelo fluxo do AdMate. Siga as instruções atuais do app em vez de copiar credenciais de outro ambiente.

Teste com um evento não sensível sempre que possível. Nunca inclua uma chave secreta ou o valor completo de autorização do webhook em uma captura de tela, repositório ou tópico público de suporte.

Verifique de ponta a ponta

Confira toda a cadeia:

O RevenueCat aceita a configuração do webhook.
Um evento compatível é entregue com sucesso.
A API do AdMate consegue resolver o contexto do dispositivo e do projeto.
A entrega de push é aceita pelo serviço da plataforma.
O dispositivo continua registrado e permite notificações.
O projeto, o app, o idioma e a moeda exibidos estão corretos.

Uma atualização bem-sucedida do painel verifica apenas outro caminho.

Solução de problemas

O RevenueCat informa um erro de webhook

Verifique o endpoint, a autorização e o status da resposta no RevenueCat. Não troque chaves do painel que não têm relação com o problema.

O webhook funciona, mas nenhuma notificação chega

Verifique o contexto do dispositivo, a permissão de push, o registro e se o tipo de evento é compatível. O contexto do dispositivo pode expirar após um período de inatividade.

A notificação mostra o nome de projeto errado

Atualize o contexto a partir do projeto correto e confirme que duas contas não foram associadas ao mesmo nome de exibição.

Um dispositivo funciona e outro não

Cada dispositivo tem seu próprio registro e contexto. Teste as permissões e o contexto no dispositivo afetado.

Regras de segurança

Mantenha a autorização de webhooks e as chaves dos provedores fora do Git.
Não registre em logs payloads completos com identificadores de clientes ou transações.
Não use a API de webhooks como depósito de dados de receita.
Troque imediatamente qualquer autorização exposta.
Remova o contexto de um dispositivo quando ele não precisar mais receber eventos.

Perguntas frequentes

O AdMate guarda todo o meu histórico do RevenueCat no servidor?

Não. A API processa eventos de webhook e um contexto temporário de dispositivo e projeto; o app consulta diretamente os serviços configurados.

Por que preciso de uma conta no painel e também de um webhook?

Eles atendem a caminhos diferentes: relatórios interativos e notificações de eventos entregues pelo servidor.

Um webhook pode corrigir métricas ausentes no painel?

Não. Verifique a autorização do RevenueCat no app e o mapeamento dos projetos.

O que um relatório de suporte seguro deve conter?

Tipo de evento, horário aproximado, status com dados ocultos e o contexto do dispositivo e do app, nunca chaves secretas ou identificadores completos de clientes.