REST API

Uma REST API (Representational State Transfer Application Programming Interface) é uma interface padronizada para a comunicação entre sistemas de software através de HTTP. Permite o acesso programático a serviços como plataformas de mensagens – estruturado, escalável e independente da plataforma.

O que é uma REST API?

Uma REST API é uma interface de programação que permite que as aplicações comuniquem entre si através de pedidos HTTP padronizados. REST significa «Representational State Transfer» – um estilo de arquitetura assente em tecnologias web existentes: métodos HTTP (GET, POST, PUT, DELETE), URLs como endereços de recursos e JSON ou XML como formatos de dados.

No contexto das mensagens, isto significa: o seu software envia um pedido POST para um URL como https://api.sendseven.com/v1/messages com dados JSON (destinatário, texto da mensagem, canal), a API processa o pedido e devolve uma resposta (por exemplo, «Mensagem enviada, ID: 12345»).

As REST APIs não têm estado (stateless) – cada pedido contém toda a informação necessária. A autenticação é feita através de chaves de API, OAuth ou Bearer Tokens. As respostas usam códigos de estado HTTP padrão (200 OK, 401 Unauthorized, 500 Server Error) para um tratamento de erros consistente.

Por que são as REST APIs importantes para as mensagens?

As REST APIs tornam as plataformas de mensagens acessíveis por programação – sem operação manual, com automação total:

• Integração de sistemas – CRM, ERP e plataformas de e-commerce enviam mensagens automaticamente
• Automação – Confirmações de encomenda, notificações de envio, lembretes de marcação
• Escalabilidade – Processar milhares de mensagens em paralelo
• Independente da plataforma – Qualquer linguagem de programação (Python, Node.js, PHP, Java) consegue fazer pedidos HTTP
• Tecnologia padrão – Os programadores conhecem REST; não há protocolos proprietários para aprender

Ao contrário das interfaces gráficas, as REST APIs permitem uma comunicação orientada a eventos: «Quando uma encomenda é efetuada, envia uma confirmação por WhatsApp.» Isto possibilita fluxos de trabalho em tempo real sem intervenção manual.

Exemplo prático

Uma loja online quer enviar uma confirmação por WhatsApp após cada encomenda. A loja usa a REST API da SendSeven:

POST https://api.sendseven.com/v1/messages

Corpo do pedido (JSON):

{
  "to": "+351912345678",
  "channel": "whatsapp",
  "text": "Obrigado pela sua encomenda #12345! Enviamos o seu pacote amanhã."
}

A API autentica o pedido através da chave de API no cabeçalho, valida os dados, encaminha a mensagem para a Cloud API do WhatsApp e devolve uma resposta:

{
  "messageId": "msg_abc123",
  "status": "sent",
  "timestamp": "2026-02-19T14:32:00Z"
}

A loja guarda o ID da mensagem para acompanhar mais tarde o estado de entrega através de webhooks. Tudo automatizado – sem passos manuais.

REST API da SendSeven

A REST API da SendSeven está totalmente documentada, é amigável para programadores e moderna: especificação OpenAPI (Swagger), documentação interativa com funcionalidade «experimente já» e exemplos de código em todas as linguagens principais.

Endpoint unificado: /v1/messages funciona para WhatsApp, Telegram, E-mail, SMS, Messenger, Instagram e Live Chat – um único formato de pedido para todos os canais. Suporte de webhooks para eventos em tempo real (message.received, message.delivered, message.read).

Autenticação através de chave de API (simples) ou OAuth 2.0 (empresarial). Limites de taxa transparentemente documentados. Conforme com o RGPD, alojada na UE. Documentação completa da API: docs.sendseven.com