🔀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.

A URL de base de todos os endpoints é: https://web.smsfunnel.com.br/api/parceiros/v1

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.

---

Endpoints

GET /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:

{
  "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

Esses são os mesmos valores aceitos no filtro ?status=. Qualquer outro valor retorna 422.

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

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.

Envios anteriores a 12 de agosto de 2026 não aparecem. Eles não possuem identificador público nem retorno da operadora.

---

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:

{
  "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.