O que é PSR e como ele funciona na prática
PSR no contexto do WhatsApp se refere ao protocolo de status de mensagem — basicamente, o sistema de Notificações de Serviço (Service Delivery Receipts) que o WhatsApp gera automaticamente para cada mensagem trafegada. Quando você envia uma mensagem pela API do WhatsApp Business ou por soluções de bulk, o servidor devolve um callback com o status atual do objeto: enviado, entregue, lido ou falha. Esse retorno é o PSR. Ele não é um recurso visível no app comum do usuário final. É uma camada técnica que aparece no payload das webhooks ou nas respostas da API quando você opera do lado do provedor (Twilio, Meta Cloud API, Zenvia, etc.). O campo relevante vem como status no evento de message, e os valores possíveis são algo como sent, delivered, read, failed — cada um com seu timestamp exato.
O que é psr no whatsapp e por que ele importa
A questão prática é: sem PSR, você não sabe se a mensagem realmente chegou. E sem saber isso, relatatórios de campanha, conciliação financeira e até a saúde da sua entrega (deliverability) viram chutes. O PSR é o que transforma "enviei e torci" em dados. Eu já fiz uma integração em que o provedor retornava delivered para milhares de mensagens, mas a taxa de leitura real cairia para 12% depois de três dias. O problema não era o PSR em si — ele estava funcionando normalmente —, e sim o fato de que os números verdes (read receipts) só aparecem quando o contato abre a conversa. Isso significa que um PSR marcando delivered não é garantia de que o usuário leu. Só confirma que o WhatsApp entregou na caixa de entrada. Confundir esses dois estados é um erro clássico de quem começa a operar com a API.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Outro ponto que as pessoas esquecem: o PSR também registra falhas com códigos específicos. Se o número está bloqueado, desativado, ou se o WhatsApp rejeitou a mensagem por conteúdo, o callback volta com failed + um código de erro. Tratar esses códigos de forma inteligente — separando bloqueio de usuário de rejeição de plataforma — economiza tempo significativo na limpeza de bases e na configuração de regras de retry. Se você quer ver isso na prática, a forma mais direta é disparar uma mensagem de teste pela API e observar o webhook. O payload vai conter algo como:
{"status": "delivered", "timestamp": "2026-07-15T14:32:01Z", "id": "msg_abc123"} Isso é o PSR falando. A partir daí, você constrói a lógica: registar no banco, atualizar o CRM, disparar follow-up após X horas se o status permanecer delivered sem evoluir para read.
Um detalhe importante que quase ninguém menciona: o tempo entre o envio e o primeiro callback de PSR varia. Em condições normais, sent chega em segundos, delivered em alguns segundos a poucos minutos, e read pode levar horas ou nunca acontecer. Se o seu sistema espera o PSR em tempo real e trava numa thread bloqueada, você vai ter problemas de throughput. Use filas assíncronas e processamento não bloqueante. Isso resolve a maior parte dos gargalos operacionais que vejo em integrações reais. Se o seu objetivo é apenas saber se o usuário leu, e não há necessidade de auditoria ou compliance, você pode simplificar e usar apenas o status delivered como indicador primário. O read é interessante para métricas, mas consome mais recurso de processamento e nem sempre se materializa. A escolha depende do que você precisa validar, não do que seria ideal teoricamente.
