Introdução
Durante o envio de Pushs transacionais de status do pedido via integração VTEX, alguns disparos podem apresentar o status:
Destinatário não encontrado
Esse retorno acontece quando a Inngage não consegue localizar um usuário apto a receber Push utilizando o e-mail enviado pela VTEX no evento do pedido.
Para que o envio seja realizado corretamente, o usuário precisa:
- possuir um cadastro identificado pelo mesmo e-mail enviado pela VTEX
- ter realizado login ou se identificado no app/site utilizando esse e-mail
- possuir permissão ativa para receber notificações Push
- possuir um device token válido registrado na Inngage
Caso esse vínculo não exista, o usuário não será encontrado na base de Push e o envio não poderá ser realizado.
Neste documento, explicamos o motivo desse comportamento, como funciona a identificação do usuário e quais verificações devem ser realizadas.
Como funciona a identificação do destinatário?
Na integração de status do pedido da VTEX, a plataforma envia para a Inngage algumas informações do pedido, incluindo:
- order_id
- email do cliente
A partir do e-mail recebido, a Inngage realiza uma busca na base de subscribers para localizar o usuário correspondente que possui permissão de Push.
Ou seja:
- A VTEX envia o evento do pedido
- A Inngage recebe o e-mail do cliente
- A plataforma procura um subscriber cadastrado com esse mesmo identificador
- Caso encontre → o Push é enviado
- Caso não encontre → o status será:
Destinatário não encontrado
Principais causas do problema
1. Usuário não identificado com o mesmo e-mail
Esse é o cenário mais comum.
A VTEX envia um e-mail no evento do pedido, porém esse mesmo e-mail não está vinculado ao usuário cadastrado para Push na Inngage.
Isso pode acontecer quando o cliente:
- não realizou login
- navegou anonimamente
- utilizou outro e-mail no app/site
- não foi identificado corretamente pela integração
Exemplo
A VTEX envia:
email: [email protected]
Mas o usuário registrado na Inngage:
- não possui esse e-mail vinculado
- ou não está identificado na base
Nesse caso, o Push não encontra o destinatário.
2. Usuário nunca permitiu notificações Push
Para receber Push Notifications, o usuário precisa aceitar as permissões de notificação no navegador ou aplicativo.
Se isso nunca aconteceu:
- não existirá um dispositivo válido para envio
- o usuário não estará apto para receber Push
3. Device token inválido ou inexistente
Mesmo que o usuário exista na base, o envio depende de um device token válido.
O que é um device token?
Esse token funciona como o “endereço” do dispositivo, permitindo que a Inngage envie notificações para aquele aparelho específico.
4. Usuário perdeu a permissão de Push
Também pode acontecer quando o usuário:
- removeu a permissão de notificações
- desinstalou o aplicativo
- limpou os dados do navegador
- reinstalou o app
- teve o token expirado pelo sistema operacional
Nesses casos, o dispositivo deixa de ser válido para envio.
Importante
O status:
Destinatário não encontrado
Não significa necessariamente erro na integração da VTEX.
Na maioria dos casos, significa apenas que não foi encontrado um subscriber válido associado ao e-mail recebido para realizar o envio do Push.
