> For the complete documentation index, see [llms.txt](https://docs.smsfunnel.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smsfunnel.com.br/api/parceiros/envios-de-uma-sequencia.md).

# Envios de uma Sequência

O que aconteceu com os SMS que uma sequência disparou

Enquanto os endpoints de Sequências definem o que será enviado, este endpoint mostra o que aconteceu com cada mensagem já disparada por uma sequência: se saiu, quando saiu e, quando a operadora informa, se foi entregue.\
\
É o equivalente de broadcasts/{id}/contacts para a automação.

{% hint style="success" %}
**A URL de base de todos os endpoints é**: <https://web.smsfunnel.com.br/api/parceiros/v1>
{% endhint %}

{% hint style="info" %}
Diferente dos endpoints de Sequências, este retorna um envelope paginado (com data). A paginação não traz total nem last\_page — para percorrer a lista inteira, siga o next\_page\_url até que venha null.
{% endhint %}

***

### Endpoints

<mark style="color:green;">**GET**</mark> /sms/sequences/{idSequencia}/messages

**Função:** Lista os envios de SMS feitos por uma sequência, do mais antigo para o mais recente.

**Corpo de resposta — `200 OK`:**

```json5
{
  "current_page": 1,
  "data": [
    {
      "id": "019ff28e-0085-71c3-8832-ce476be5f754",
      "phone": "5511999990001",
      "message": "Olá Fulano, sua oferta está ativa!",
      "status": "delivered",
      "cancelled": false,
      "created_at": "2026-08-11T14:23:01-03:00",
      "sent_at": "2026-08-11T14:25:13-03:00"
    }
  ],
  "per_page": 50,
  "from": 1,
  "to": 1,
  "first_page_url": "https://web.smsfunnel.com.br/api/parceiros/v1/sms/sequences/{id}/messages?page=1",
  "next_page_url": null,
  "prev_page_url": null,
  "path": "https://web.smsfunnel.com.br/api/parceiros/v1/sms/sequences/{id}/messages"
}
```

***

### Tabela de status

{% hint style="info" %}
Esses são os mesmos valores aceitos no filtro ?status=. Qualquer outro valor retorna 422.
{% endhint %}

| `status`           | Significado                                                           |
| ------------------ | --------------------------------------------------------------------- |
| queued             | Na fila, ainda não despachado                                         |
| sent\_to\_carrier  | Despachado da nossa fila para a operadora                             |
| delivered          | Entrega confirmada pela operadora                                     |
| blocked\_blacklist | Bloqueado por blacklist                                               |
| cancelled          | Não saiu: cancelamento seu, crédito insuficiente ou telefone inválido |

{% hint style="warning" %}
**sent\_to\_carrier** pode ser o estado final, pois nem todos os retornos podem chegar. Use delivered como confirmação positiva, mas não interprete sent\_to\_carrier como pendência que será resolvida — ela pode permanecer assim para sempre, mesmo tendo sido entregue.
{% endhint %}

{% hint style="info" %}
Envios anteriores a 12 de agosto de 2026 não aparecem. Eles não possuem identificador público nem retorno da operadora.&#x20;
{% endhint %}

***

### Código de Erros Comuns

* `401 Unauthorized` (`UNAUTHORIZED`): Não foi possível identificar o parceiro a partir da Chave de API.
* `404 Not Found` (`NOT_FOUND`): A sequência não foi encontrada ou não pertence à sua conta.
* `422 Unprocessable Entity` (`VALIDATION_ERROR`): Algum campo do corpo da requisição é inválido (inclui `{meu_link}` sem `url`, ou `url` sem `{meu_link}` no texto).

**Corpo de resposta de erro:**

```json5
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid status filter.",
    "details": {
      "status": [
        "Expected one of: queued, sent_to_carrier, delivered, blocked_blacklist, blocked_content, cancelled."
      ]
    }
  }
}
```

#### Dúvidas?

Em caso de dúvidas, entre em contato com nosso suporte.