> ## Documentation Index > Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt > Use this file to discover all available pages before exploring further. # Status de entrega de mensagens > Distinga aceitação, envio, entrega, leitura e falha ao rastrear uma mensagem de saída do WhatsApp. Enviar uma solicitação e entregar uma mensagem são eventos diferentes. Uma resposta de API bem-sucedida confirma o resultado da solicitação nessa etapa; ela não garante que o cliente recebeu ou leu a mensagem. Use o status da mensagem da YCloud e quaisquer detalhes de erro disponíveis para entender o que aconteceu. ## Status de mensagens de saída O recurso de mensagens de saída do WhatsApp da YCloud usa estes status: | Status | Significado | O que fazer | | - | - | - | | `accepted` | A YCloud aceitou a solicitação de envio de mensagem. | Acompanhe as atualizações posteriores. Não trate isso como entrega. | | `sent` | A mensagem está em trânsito nos sistemas do WhatsApp. | Aguarde uma atualização de entrega ou falha. | | `delivered` | A mensagem chegou ao dispositivo do cliente. | Trate-a como entregue, não necessariamente lida. | | `read` | O WhatsApp informou que o cliente leu a mensagem. | Use o sinal no seu fluxo de trabalho sem presumir que a leitura significa concordância ou conclusão. | | `failed` | Ocorreu uma falha no envio da mensagem. | Inspecione o erro e corrija a causa antes de tentar novamente. | Uma progressão típica de sucesso é `accepted → sent → delivered → read`. Não presuma que seu aplicativo receberá todas as atualizações intermediárias ou que as atualizações chegarão exatamente nessa ordem. ## Por que uma solicitação bem-sucedida não é a entrega final Com o endpoint enfileirado, a YCloud aceita a solicitação e a envia de forma assíncrona. Com o endpoint direto, o envio para a WhatsApp Business API ocorre de forma síncrona. A entrega final ainda é assíncrona em ambos os casos. Para detalhes de implementação, consulte [Enviar uma mensagem do WhatsApp](/pt/api-reference/guides/whatsapp-platform/send-whatsapp-message). Se o status atual ainda for `accepted` ou `sent`, não envie repetidamente o mesmo conteúdo. Uma solicitação adicional pode resultar em mensagem duplicada. ## Confirmações de entrega e leitura Entregue significa que a mensagem chegou ao dispositivo do cliente. Não significa que o cliente abriu a conversa. As confirmações de leitura não estão disponíveis em todas as situações. Por exemplo, as configurações de confirmação de leitura do cliente podem afetar se uma atualização de leitura é reportada. A ausência de uma atualização de leitura não é prova de que o cliente ignorou a mensagem. Para obter as definições de status upstream, consulte a [referência de webhooks de status de mensagem](https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/components/) da Meta. ## Rastrear a mesma mensagem em diferentes sistemas Ao solucionar problemas, mantenha as seguintes informações reunidas: | Informação | Por que ajuda | | - | - | | ID da mensagem na YCloud | Identifica o recurso de mensagem na YCloud. | | ID da mensagem no WhatsApp, quando disponível | Correlaciona a mensagem com o processamento upstream do WhatsApp. | | Remetente, destinatário e WABA | Identifica a empresa e a interação afetadas. | | Sua referência externa, se utilizada | Conecta a mensagem a um pedido, chamado de suporte ou outro evento interno. | | Timestamps de status | Ajuda a reconstruir a sequência quando as atualizações chegam com atraso ou fora de ordem. | | Detalhes do erro | Explica uma falha e orienta a próxima ação. | Não inclua chaves de API nem informações desnecessárias de clientes ao compartilhar registros para solução de problemas. Integrações via API podem receber Webhooks de `whatsapp.message.updated` e recuperar o recurso da mensagem. Consulte as [práticas recomendadas para mensagens no WhatsApp](/pt/api-reference/guides/whatsapp-platform/whatsapp-messages-api-best-practices) para sincronização e tratamento de novas tentativas. ## Investigar uma mensagem com falha Comece pelo erro retornado, não apenas pelo nome do status. * **Problema no modelo:** confirme se o modelo de mensagem está disponível e se o idioma e os parâmetros estão corretos. * **Problema na janela:** verifique se a mensagem requer uma [janela de atendimento ao cliente](/pt/documentation/whatsapp-business-platform/messaging/service-messages#customer-service-window) aberta. * **Problema na conta ou número:** inspecione o ativo afetado e suas restrições atuais. * **Problema de conteúdo ou mídia:** verifique os requisitos do tipo de mensagem selecionado. * **Controle de entrega:** siga a orientação de erro específica. Novas tentativas imediatas e repetidas podem não resolver uma restrição da plataforma. Uma mensagem com falha não comprova que um cliente bloqueou seu número. Use os detalhes reais do erro e evite inferir comportamentos do cliente que a plataforma não relatou. Para controles de entrega da plataforma, consulte [Controles de qualidade e entrega](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/quality-and-delivery-controls). Para notificações de aplicação de medidas, consulte [Restrições de conta e recursos](/pt/documentation/whatsapp-business-platform/consent-policies-and-account-health/account-restrictions-and-appeals). ## Decidir se tentar novamente é seguro | Evidência atual | Tratamento recomendado | | - | - | | A solicitação retornou um ID e o status não é final | Continue rastreando essa mensagem. Não envie outra cópia apenas porque um cliente não respondeu. | | A solicitação atingiu o tempo limite e você não sabe se ela foi aceita | Faça a reconciliação usando o contexto da solicitação armazenado e os registros de mensagens disponíveis antes de tentar novamente. Um tempo limite esgotado não é prova de que nada foi enviado. | | Falha permanente de conteúdo, modelo ou permissão | Corrija a entrada subjacente ou interrompa o envio. Repetir a mesma solicitação não resolverá o problema. | | Falha técnica temporária | Tente novamente apenas de acordo com as orientações de erro específicas, com um intervalo, um limite de tentativas e a verificação de que a mensagem ainda é útil. | | O cliente cancelou o recebimento (opt-out) ou um controle no nível do destinatário bloqueia a entrega | Suprima a comunicação afetada; não alterne os remetentes para forçar a entrega. | | O evento de negócios tornou-se obsoleto | Cancele a nova tentativa, mesmo que o erro técnico pudesse ser tentado novamente. | Um bom registro de mensagem vincula uma ação de negócios pretendida às suas solicitações e resultados. Sua referência externa ajuda na correlação, mas não presuma que ela forneça idempotência de API, a menos que o endpoint garanta explicitamente esse comportamento. ### Exemplo de atualizações de status atrasadas Seu sistema recebe `delivered` e, em seguida, um evento `sent` atrasado para a mesma mensagem. Não altere o status do cliente de volta para “não entregue”. Armazene os carimbos de data/hora dos eventos e aplique um modelo de estado que tolere atualizações duplicadas e fora de ordem. Da mesma forma, a ausência de um evento `read` não significa que a mensagem falhou. Separe estas métricas: * **Alcance de entrega:** mensagens com comprovação de entrega. * **Alcance de leitura:** mensagens com confirmação de leitura reportada. * **Resposta do cliente:** uma resposta ou interação real recebida. * **Conversão de negócios:** uma reserva confirmada, compra ou verificação bem-sucedida no sistema responsável por ela. ## Próximos passos * [Revisar regras de mensagens](/pt/documentation/whatsapp-business-platform/messaging/how-messaging-works). * [Verificar mensagens de serviço](/pt/documentation/whatsapp-business-platform/messaging/service-messages). * [Implementar rastreamento de entrega](/pt/api-reference/guides/whatsapp-platform/send-whatsapp-message). * [Entrar em contato com o suporte da YCloud](/pt/documentation/support/ycloud-support-team) com os identificadores de mensagem e detalhes de erro relevantes. ## Perguntas frequentes Você não pode concluir isso. As confirmações de leitura podem estar indisponíveis, inclusive quando o destinatário as desativa. Mantenha entregue e lido como medições separadas. Nem a ausência de uma confirmação de leitura nem um erro geral de não entrega identifica o motivo do cliente ou comprova bloqueio. Não imediatamente. A plataforma já pode ter aceitado a solicitação. Verifique o identificador da mensagem, os logs disponíveis e os eventos de webhook posteriores antes de emitir outro envio. Correlacione as tentativas à mesma ação de negócios e crie proteção contra duplicatas; uma referência externa não garante automaticamente a idempotência do endpoint. Uma limitação de exibição e uma falha de entrega são coisas diferentes. Inspecione a direção real, o status, o tipo de mensagem e qualquer erro. Para conteúdo recebido, siga o [guia de mensagem não compatível da Caixa de Entrada](/pt/documentation/inbox/unsupported-messages-in-inbox); não tente adivinhar o conteúdo nem considere um espaço reservado como uma falha de envio de saída. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.