Durante o envio de push transacional de status do pedido pela integração VTEX, alguns disparos retornam o status "Destinatário não encontrado". Isso acontece quando a Inngage Context Cloud não localiza um usuário apto a receber push com o e-mail enviado pela VTEX no evento do pedido.
Condições para o envio
Para que o push seja enviado corretamente, o usuário precisa:
- Ter um cadastro identificado pelo mesmo e-mail enviado pela VTEX.
- Ter feito login ou se identificado no app/site com esse e-mail.
- Ter permissão ativa para receber notificações push.
- Ter um device token válido registrado na Context Cloud.
Sem esse vínculo, o usuário não é encontrado na base de push e o envio não pode ser realizado.
Como funciona a identificação do destinatário
Na integração de status do pedido da VTEX, a VTEX envia à Context Cloud algumas informações do pedido, incluindo o order_id e o email do cliente. A partir do e-mail recebido, a Context Cloud busca na base de subscribers o usuário correspondente que tenha permissão de push.
O fluxo é:
- A VTEX envia o evento do pedido.
- A Context Cloud recebe o e-mail do cliente.
- A plataforma procura um subscriber cadastrado com esse mesmo identificador.
- Se encontra, o push é enviado. Se não encontra, o status é "Destinatário não encontrado".
Principais causas
1. Usuário não identificado com o mesmo e-mail
É o cenário mais comum. A VTEX envia um e-mail no evento do pedido, mas esse e-mail não está vinculado a um usuário cadastrado para push na Context Cloud. Isso pode ocorrer quando o cliente:
- Não realizou login.
- Navegou anonimamente.
- Utilizou outro e-mail no app/site.
- Não foi identificado corretamente pela integração.
Por exemplo: a VTEX envia cliente@exemplo.com, mas o usuário registrado na Context Cloud não tem 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, o usuário precisa aceitar as permissões de notificação no navegador ou no aplicativo. Se isso nunca aconteceu, não existe um dispositivo válido para envio e o usuário não está apto a 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 device token é um identificador único gerado pelo Android ou iOS quando o usuário permite receber notificações push. Ele funciona como o "endereço" do dispositivo, permitindo que a Context Cloud 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 um 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.
