---
title: "Documentação Técnica — Status de Conexões"
description: "Documentação sobre cada status de mensagem nas conexões"
url: https://help.datacrazy.io/pt-br/articles/10670819-documentacao-tecnica-—-status-de-conexoes
collection: "Conexões"
updated: 2026-08-18
language: pt-br
---

# Documentação Técnica — Status de Conexões

Documentação sobre cada status de mensagem nas conexões

## 1\. Visão Geral

O sistema utiliza um conjunto padronizado de **status para representar o ciclo de vida das mensagens**, independentemente do tipo de conexão utilizada.

Embora os status sejam os mesmos para todas as integrações, a forma como cada status é alcançado pode variar de acordo com a existência ou não de um **webhook de confirmação de entrega**.

Atualmente, existem dois grupos de conexões:

-   **Conexões com webhook de confirmação**
    
-   **Conexões sem webhook de confirmação**
    

Essa diferença é especialmente importante para determinar quando uma mensagem pode ser considerada efetivamente como `sent`.

* * *

## 2\. Status Disponíveis

Status

Descrição

<table data-id="9e26019d-c384-45c1-a228-62f9f2262b37" style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="efa8db5c-99fa-4f64-a44b-1e521ee3524b"><code>pending</code></p></td><td colspan="1" rowspan="1"><p data-id="a1f7316f-6ef0-44d9-915e-31901438b4ee">Mensagem criada e aguardando o processo de envio.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="503172d8-8a56-479f-9061-906ff7593aa9"><code>sent</code></p></td><td colspan="1" rowspan="1"><p data-id="433f57c3-6dab-46eb-8836-64c3fa19a4ed">Mensagem considerada enviada com sucesso.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="81959d47-94a1-472a-8594-2326a694d039"><code>received</code></p></td><td colspan="1" rowspan="1"><p data-id="68dd33ac-1ff6-4173-b4cf-4b9579e16a6e">Mensagem confirmada como recebida pelo destinatário.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="86145ab2-f075-4908-8765-40f651bedcaa"><code>visualizado</code></p></td><td colspan="1" rowspan="1"><p data-id="a9d1f82d-a39c-4e07-af1a-616f85735a44">Mensagem confirmada como visualizada pelo destinatário.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="c0b26a92-764d-43bc-90ae-b8b9a985aa6a"><code>error</code></p></td><td colspan="1" rowspan="1"><p data-id="3d3e2c4d-56ce-495e-be34-51bec96f89a6">Ocorreu uma falha durante o envio ou processamento da mensagem.</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="49a864f8-ac20-4013-8fdb-a60dee76d7eb"><code>scheduled</code></p></td><td colspan="1" rowspan="1"><p data-id="e9607623-6c76-4955-a1c8-5eccc2be5f54">Mensagem agendada para ser enviada em uma data/horário futuro.</p></td></tr></tbody></table>

* * *

## 3\. Conexões com Webhook de Confirmação

São conexões que possuem um **webhook responsável por informar o resultado da entrega da mensagem**.

Atualmente:

-   **Crazy API**
    
-   **WhatsApp Cloud**
    
-   **Z-API**
    

### Regra

Nessas conexões, o retorno da requisição inicial de envio não é suficiente para considerar a mensagem como efetivamente entregue.

O status `sent` é confirmado através do **webhook de confirmação**.

Fluxo conceitual:

```text
pending
   ↓
envio da mensagem
   ↓
confirmação via webhook
   ↓
sent
   ↓
received
   ↓
visualizado

```

* * *

## 3.1 Conexões sem Webhook de Confirmação

São conexões que não possuem um webhook externo utilizado para confirmar a entrega da mensagem.

Atualmente:

-   **UAZAPI**
    
-   **Evolution API**
    
-   **Conexão Universal**  
    

### Regra

Nessas conexões, o sistema utiliza o retorno HTTP da requisição de envio.

Quando o `POST` responsável pelo envio retorna **HTTP 200**, a mensagem é considerada enviada e o status é atualizado diretamente para:

```text
sent

```

Portanto, não é necessário aguardar uma confirmação externa para essa transição.

* * *

## 4\. Regras de Transição de Status  
  
Imutabilidade do `sent`

Uma vez que uma mensagem tenha atingido o status:

```text
sent

```

ela **não pode retornar para**:

```text
pending

```

Essa regra é válida para **todas as conexões**.

### Exemplo

```text
pending → sent

```

**É permitido.**

```text
sent → pending

```

**Não é permitido.**

Essa regra impede que uma mensagem já considerada enviada seja posteriormente tratada como se ainda estivesse aguardando envio.

* * *

## 4.1 O status `error` é final

O status:

```text
error

```

representa um **estado terminal**.

Depois que uma mensagem entra em `error`, nenhuma outra transição de status deve ocorrer.

### Permitido

```text
sent → error

```

ou:

```text
scheduled → error

```

### Não permitido

```text
error → pending
error → sent
error → received
error → visualizado

```

Portanto:

```text
error → [FIM]

```

* * *

## 5\. Regras para o Status `error`

O status `error` pode ser atingido em dois cenários.

### Erro após `sent`

No fluxo normal, após a mensagem atingir `sent`, o sistema pode aguardar uma confirmação posterior.

Caso ocorra uma falha nessa etapa, o status será alterado para:

```text
error

```

A mensagem **não continua para** `received` **ou** `visualizado`.

Fluxo:

```text
pending
   ↓
sent
   ↓
error

```

A partir de `error`, o processo é encerrado.

* * *

## 5.1 Erro em mensagem agendada

Mensagens com status `scheduled` possuem uma regra adicional.

Quando chega o horário programado, o sistema tenta realizar o envio.

Existem dois resultados possíveis:

### Sucesso

```text
scheduled → pending

```

A mensagem entra no fluxo normal de envio.

### Falha

```text
scheduled → error

```

Nesse caso, a mensagem **não passa por** `pending`.

Portanto:

```text
                 ┌──→ pending → sent → received → visualizado
scheduled ────────┤
                 └──→ error

```

* * *

## 6\. Status `received` e `visualizado`

Os status `received` e `visualizado` representam confirmações posteriores ao envio.

Eles são alcançados através de eventos de confirmação, normalmente provenientes do webhook da integração.

## Regra importante

Uma mensagem que já esteja em:

```text
received

```

ou:

```text
visualizado

```

**não deve ser alterada para** `error`**.**

Isso ocorre porque esses status representam uma confirmação passiva recebida pelo sistema.

O erro deve ser tratado nas etapas anteriores do processo, e não após uma confirmação de recebimento ou visualização.

### Fluxo válido

```text
sent → received → visualizado

```

### Fluxos inválidos

```text
received → error

```

```text
visualizado → error

```

* * *

## 7\. Hierarquia de Status — Mensagens Normais

Para mensagens que não foram agendadas, o fluxo padrão é:

```text
pending → sent → received → visualizado

```

Cada etapa representa uma evolução do estado da mensagem.

### Fluxo com erro

```text
pending → sent → error

```

O status `error` encerra o ciclo.

* * *

## 8\. Hierarquia de Status — Mensagens Agendadas

Mensagens agendadas possuem o status inicial:

```text
scheduled

```

Quando chega o horário definido para o envio, o sistema tenta iniciar o processo.

### Fluxo de sucesso

```text
scheduled
    ↓
pending
    ↓
sent
    ↓
received
    ↓
visualizado

```

### Fluxo de erro

```text
scheduled
    ↓
error

```

Portanto, existem duas ramificações possíveis a partir de `scheduled`.

* * *

## 9\. Matriz de Transições

Status Atual

Próximo Status

Condição

<table data-id="8229a2bd-2178-46ec-b2a6-2bb68b31e574" style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="d5e47c64-9360-4d8c-86aa-5e0499e47cad"><code>scheduled</code></p></td><td colspan="1" rowspan="1"><p data-id="51204a27-c9e5-413e-8970-14fa9ac1b7da"><code>pending</code></p></td><td colspan="1" rowspan="1"><p data-id="370bb9dd-be67-434c-bc5f-b9f254c04a94">Horário agendado atingido e envio iniciado com sucesso</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="8b305039-34da-4b50-9598-ea566cbf0cc8"><code>scheduled</code></p></td><td colspan="1" rowspan="1"><p data-id="262769f3-78bd-46a2-a5a3-014432b3d45b"><code>error</code></p></td><td colspan="1" rowspan="1"><p data-id="1848d326-a680-4d62-92f7-a68c541f59a5">Falha ao tentar enviar no horário agendado</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="3e36d6f6-cd40-49cb-9e21-83a38863abdd"><code>pending</code></p></td><td colspan="1" rowspan="1"><p data-id="0cbb84dc-f553-4459-a003-6ef8edd30ca0"><code>sent</code></p></td><td colspan="1" rowspan="1"><p data-id="18944e3a-7994-44b4-adf0-fa3184850344">Mensagem considerada enviada</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="bbae72b8-71e9-4835-bcb0-92be7200756c"><code>pending</code></p></td><td colspan="1" rowspan="1"><p data-id="70546903-4182-4fef-9e4c-62000a7fd8b2"><code>error</code></p></td><td colspan="1" rowspan="1"><p data-id="3b82abe3-d787-473f-918c-f516c7f2ca29">Falha no processo de envio, quando aplicável</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="306ab158-eeb8-4812-a908-833ab875c121"><code>sent</code></p></td><td colspan="1" rowspan="1"><p data-id="249f64e4-e50e-4138-a861-8812481143e4"><code>received</code></p></td><td colspan="1" rowspan="1"><p data-id="933346cd-d7f5-431b-b76a-f6f5e42b66d1">Confirmação de recebimento</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="0ed0bcb8-f2c5-42c4-b347-0c4ef8087f22"><code>sent</code></p></td><td colspan="1" rowspan="1"><p data-id="3d061af9-d69d-4516-b5bc-f6154c537950"><code>error</code></p></td><td colspan="1" rowspan="1"><p data-id="80020e47-8b36-4b4a-a39c-4dfb9cb9af29">Falha na etapa de confirmação/processamento</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="984ce65a-a833-44e4-8a95-eb7851540c2e"><code>received</code></p></td><td colspan="1" rowspan="1"><p data-id="308c58f0-81c4-408d-970f-bbd47a06203f"><code>visualizado</code></p></td><td colspan="1" rowspan="1"><p data-id="c88815f0-bc67-4f54-90b3-250b954bb555">Confirmação de visualização</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="d33ddd1c-a1c9-4733-8f38-0815ad15443c"><code>received</code></p></td><td colspan="1" rowspan="1"><p data-id="9d6a46b8-07fb-4a39-8bf8-e9ba7b2368cd"><code>error</code></p></td><td colspan="1" rowspan="1"><p data-id="bcd58388-ba76-45a2-bc0e-dec2f4d39eb6"><strong>Não permitido</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="9d5c913c-7855-4754-9394-af493eaec148"><code>visualizado</code></p></td><td colspan="1" rowspan="1"><p data-id="57dec115-d233-494b-bf8d-8b3076bcd66e">qualquer outro status</p></td><td colspan="1" rowspan="1"><p data-id="c0d42f5a-9f9a-4388-a2c7-fa42cf22e2d4"><strong>Não permitido</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="b332023f-b3fa-444b-a247-02e607332f9f"><code>error</code></p></td><td colspan="1" rowspan="1"><p data-id="90591981-ec00-4d57-a59b-23796dd2883f">qualquer outro status</p></td><td colspan="1" rowspan="1"><p data-id="ede08177-44e3-43ea-8f35-f0f00ffa40d4"><strong>Não permitido</strong></p></td></tr></tbody></table>

> **Observação:** a confirmação de `sent` varia conforme a conexão utilizada.

* * *

## 10\. Comportamento por Integração

Integração

Possui webhook de confirmação?

Como `sent` é confirmado?

<table data-id="5a8eae5d-ab83-4fd1-9ce5-5588928ac002" style="min-width: 260px;"><colgroup><col style="min-width: 25px;"><col style="width: 210px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p data-id="3b7f1b27-c246-426b-a3e9-8ca2c56b611e">Crazy API</p></td><td colspan="1" rowspan="1"><p data-id="69ea4aaa-dc0a-4490-9a4f-1f4c8cf08202">Sim</p></td><td colspan="1" rowspan="1"><p data-id="60ba2151-a0ab-4165-952f-fdb57d47a5ad">Webhook de confirmação</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="267c89f1-eed6-4c5a-9a00-303b43fade79">WhatsApp Cloud</p></td><td colspan="1" rowspan="1"><p data-id="d46c0a92-d9e8-4d7f-ad30-ccf40d31e8d3">Sim</p></td><td colspan="1" rowspan="1"><p data-id="e541cf88-10ed-4e29-817a-2228c049faa9">Webhook de confirmação</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="55110956-71d2-422a-bad6-af5f9205c030">Z-API</p></td><td colspan="1" rowspan="1"><p data-id="1977ce94-8a5c-4446-ac49-47287e2a903f">Sim</p></td><td colspan="1" rowspan="1"><p data-id="d0c1733a-2d24-41c3-be29-f601bfd07c92">Webhook de confirmação</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="0fb8af74-da4a-4bd7-9d82-f9359f13e526">UAZAPI</p></td><td colspan="1" rowspan="1"><p data-id="08dd3e12-e1b9-45a1-b780-2ae9bb9d8939">Não</p></td><td colspan="1" rowspan="1"><p data-id="f0c0b9ea-7b07-4182-a95b-0949ac46d7d7">Retorno HTTP <code>200</code> do POST</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="933026c2-48bd-49b7-a79a-4c9dd27b74dd">Evolution API</p></td><td colspan="1" rowspan="1"><p data-id="5e747385-5b36-4160-b0d1-6a6fa0351f02">Não</p></td><td colspan="1" rowspan="1"><p data-id="341d4e9f-50ff-4a05-b76c-7f96f9fb497e">Retorno HTTP <code>200</code> do POST</p></td></tr><tr><td colspan="1" rowspan="1"><p data-id="fc3d1e15-3f8f-430c-aa22-9b2fdf046fde"><strong>Conexão Universal</strong></p></td><td colspan="1" rowspan="1"><p data-id="bebe45ef-5d87-46fb-a787-bfe2681e6228">Não</p></td><td colspan="1" rowspan="1"><p data-id="e39f37b4-6c6e-44c2-acda-15306e00d557">Retorno HTTP <code>200</code> do POST</p></td></tr></tbody></table>

* * *

## 11\. Fluxos Completos

### Mensagem normal — sucesso

```text
pending
   ↓
sent
   ↓
received
   ↓
visualizado
   ↓
FIM

```

* * *

### Mensagem normal — erro

```text
pending
   ↓
sent
   ↓
error
   ↓
FIM

```

* * *

### Mensagem agendada — sucesso

```text
scheduled
   ↓
pending
   ↓
sent
   ↓
received
   ↓
visualizado
   ↓
FIM

```

* * *

### Mensagem agendada — erro

```text
scheduled
   ↓
error
   ↓
FIM

```

* * *

## 12\. Regra Principal do Ciclo de Vida

De forma simplificada, o ciclo de vida das mensagens pode ser representado da seguinte maneira:

```text
                         ┌───────────────┐
                         │scheduled/envio│
                         └───────┬───────┘
                                 │
                    ┌────────────┴────────────┐
                    │                         │
                 sucesso                    falha
                    │                         │
                    ▼                         ▼
               ┌─────────┐              ┌─────────┐
               │ pending │              │  error  │
               └────┬────┘              └────┬────┘
                    │                        │
                    ▼                        ▼
               ┌─────────┐                   FIM
               │  sent   │
               └────┬────┘
                    │
             ┌──────┴──────┐
             │             │
          sucesso         erro
             │             │
             ▼             ▼
        ┌──────────┐   ┌─────────┐
        │ received │   │  error  │
        └────┬─────┘   └────┬────┘
             │              │
             ▼              ▼
       ┌────────────┐       FIM
       │ visualizado│
       └─────┬──────┘
             │
             ▼
            FIM

```

**Regra fundamental:** os status representam uma evolução do ciclo de vida da mensagem. O sistema não deve permitir regressões ou alterações incompatíveis com as transições definidas nesta documentação.
