> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Failure by unable to contact no WhatsApp

> Descrição do erro `FAILURE_BY_UNABLE_TO_CONTACT` exibido nos relatórios do WhatsApp.

Este status indica que **o WhatsApp não conseguiu entregar a mensagem naquele momento específico**, porque não encontrou um dispositivo do usuário que pudesse **receber e processar corretamente esse tipo de mensagem**.

👉 **Não significa** que:

* O número seja inválido
* O usuário tenha te bloqueado
* Exista um erro na sua conta ou configuração

É uma **falha temporária**. Esta mensagem de status pode ser confusa, mas na maioria dos casos **não indica um problema grave nem requer ação da sua parte**.

***

## 📱 Por que isso pode acontecer?

Este status geralmente aparece em situações normais de uso do WhatsApp, por exemplo:

### 1. O usuário está usando WhatsApp Web

Algumas mensagens (como botões, listas, fluxos ou funcionalidades novas) **só estão disponíveis no WhatsApp móvel**.

Se o usuário:

* Está ativo no WhatsApp Web
* Mas o celular não está disponível (desligado, sem internet, em segundo plano)

O WhatsApp não consegue entregar a mensagem naquele momento.

***

### 2. O aplicativo WhatsApp do usuário não está atualizado

Algumas funcionalidades novas requerem versões recentes do WhatsApp.

Se a mensagem usa uma funcionalidade mais nova que a versão instalada do usuário:

* A mensagem ainda não pode ser exibida
* O WhatsApp marca a tentativa como não entregue temporariamente

***

### 3. Problemas temporários de conexão

Também pode ocorrer se:

* O celular está sem sinal ou sem internet
* O dispositivo está desligado
* O sistema fechou o WhatsApp para economizar bateria

***

## ⏳ Por que a mensagem pode aparecer como `delivered` mais tarde?

O WhatsApp **tenta novamente a entrega de maneira automática**.

Quando o usuário:

* Abre o WhatsApp no celular
* Atualiza o aplicativo
* Recupera a conexão com a internet

A mensagem pode ser entregue corretamente e mudar seu status para:

✅ **`delivered` (entregue)**

Isso é **completamente normal** e esperado.

***

## 🧘‍♂️ Devo me preocupar se vejo este status?

**Não.**

Recomendações:

* Não é necessário reenviar a mensagem imediatamente
* Não indica um erro permanente
* Não afeta a conversa nem o usuário final

Na maioria dos casos, a mensagem é entregue apenas alguns minutos ou horas depois.

***

## 🧠 Resumo rápido

* `FAILURE_BY_UNABLE_TO_CONTACT` = falha **temporária**, não definitiva
* Geralmente ocorre por uso do WhatsApp Web, versões antigas ou falta momentânea de conexão
* O WhatsApp tenta novamente a entrega de maneira automática.
* É normal que a mensagem termine como **`delivered`** mais tarde