Terramar - API de Notificacoes Multi-Canal

Funcionalidades

Tudo o que precisa para comunicar com os seus clientes

📅

Agendamento

Agende mensagens para envio futuro com a API v2. Cancele a qualquer momento antes do envio.

🔗

Webhooks

Receba notificacoes em tempo real sobre o status de entrega das suas mensagens.

🔄

Retry Automatico

Mensagens falhadas sao automaticamente reenviadas ate 3 vezes com backoff exponencial.

💰

Sistema de Creditos

Modelo pre-pago com saldo em MZN. Precos configuraveis por canal com debito atomico.

🔨

Integracao ERP

Endpoint simplificado para ERPs enviarem notificacoes automaticas de eventos.

🔐

Autenticacao Segura

Basic Auth (account_sid:auth_token em Base64) para integracao e JWT para painel de gestao.

📊

Dashboard Admin

Painel completo com estatisticas, gestao de clientes, creditos e aprovacoes.

🗒

Templates WhatsApp

Gestao de templates com fluxo de aprovacao. Suporte a variaveis dinamicas.

Novo na v2: Agendamento de Mensagens

Programe o envio de mensagens para uma data e hora especifica. Ideal para campanhas, lembretes e notificacoes programadas.

Envie o campo scheduled_at com data ISO 8601
Mensagem fica com status scheduled ate a hora chegar
Cancele mensagens agendadas antes do envio
Filtre mensagens agendadas com ?scheduled=true
Worker verifica mensagens agendadas a cada 15 segundos

POST/v2/messages

              {
  "channel": "sms",
  "to": "+258841234567",
  "body": "Lembrete: reuniao amanha",
  "from": "MyApp",
  "scheduled_at": "2026-02-01T09:00:00Z"
}
            

DELETE/v2/messages/:id/schedule

              // Cancela mensagem agendada
// Resposta:
{ "message_id": "uuid", "status": "cancelled" }
            

API Reference

Base URL: https://terrar.360bulkmessenger.co.mz

POST/v2/messages

            curl -X POST https://terrar.360bulkmessenger.co.mz/v2/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic $(echo -n 'acc_5797551fc16ff974ba08b669e70c5610:sk_55dc988b0b8c0b6eb70326ca221574b53f5a22b5e523c0a2' | base64)" \
  -d '{
    "channel": "sms",
    "to": "+258841234567",
    "body": "Ola, teste SMS!",
    "from": "MyApp"
  }'
          

GET/v2/messages?status=sent&channel=sms&limit=20

            // Listar mensagens com filtros
// Params: status, channel, scheduled, limit, offset
          

GET/v2/messages/:id

            // Ver detalhes de uma mensagem especifica

POST/v2/messages

            curl -X POST https://terrar.360bulkmessenger.co.mz/v2/messages \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic $(echo -n 'acc_5797551fc16ff974ba08b669e70c5610:sk_55dc988b0b8c0b6eb70326ca221574b53f5a22b5e523c0a2' | base64)" \
  -d '{
    "channel": "sms",
    "to": "+258841234567",
    "body": "Mensagem agendada!",
    "from": "MyApp",
    "scheduled_at": "2026-02-01T10:00:00Z"
  }'
          

DELETE/v2/messages/:id/schedule

curl -X DELETE https://terrar.360bulkmessenger.co.mz/v2/messages/MSG_ID/schedule \
  -H "Authorization: Basic $(echo -n 'acc_5797551fc16ff974ba08b669e70c5610:sk_55dc988b0b8c0b6eb70326ca221574b53f5a22b5e523c0a2' | base64)"

GET/v2/messages?scheduled=true

            // Listar apenas mensagens agendadas

POST/v2/webhooks

curl -X POST https://terrar.360bulkmessenger.co.mz/v2/webhooks \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic $(echo -n 'acc_5797551fc16ff974ba08b669e70c5610:sk_55dc988b0b8c0b6eb70326ca221574b53f5a22b5e523c0a2' | base64)" \
  -d '{
    "url": "https://seusite.com/webhook"
  }'

GET/v2/webhooks

            // Consultar webhook configurado

DELETE/v2/webhooks

            // Remover webhook

Payload recebido no seu webhook

            {
  "message_id": "uuid",
  "status": "sent",
  "channel": "sms",
  "timestamp": "2026-01-30T12:00:00.000Z"
}
          

POST/v2/webhook/erp

            curl -X POST https://terrar.360bulkmessenger.co.mz/v2/webhook/erp \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic $(echo -n 'acc_5797551fc16ff974ba08b669e70c5610:sk_55dc988b0b8c0b6eb70326ca221574b53f5a22b5e523c0a2' | base64)" \
  -d '{
    "evento": "nova_venda",
    "telefone": "+258841234567",
    "mensagem": "Compra confirmada!",
    "canal": "sms"
  }'
          

POST/v2/sender-ids

curl -X POST https://terrar.360bulkmessenger.co.mz/v2/sender-ids \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic $(echo -n 'acc_5797551fc16ff974ba08b669e70c5610:sk_55dc988b0b8c0b6eb70326ca221574b53f5a22b5e523c0a2' | base64)" \
  -d '{
    "sender_id": "MyApp"
  }'

GET/v2/sender-ids

            // Listar Sender IDs

DELETE/v2/sender-ids/:id
            
            // Remover Sender ID

POST/v2/templates

            curl -X POST https://terrar.360bulkmessenger.co.mz/v2/templates \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic $(echo -n 'acc_5797551fc16ff974ba08b669e70c5610:sk_55dc988b0b8c0b6eb70326ca221574b53f5a22b5e523c0a2' | base64)" \
  -d '{
    "name": "boas_vindas",
    "language": "pt_BR",
    "body": "Ola {{1}}, bem-vindo!"
  }'
          

GET/v2/templates

            // Listar templates WhatsApp

DELETE/v2/templates/:id
            
            // Remover template

POST/v2/auth/register

            curl -X POST https://terrar.360bulkmessenger.co.mz/v2/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Joao Silva",
    "email": "joao@empresa.co.mz",
    "password": "senha123",
    "company_name": "Minha Empresa"
  }'
          

POST/v2/auth/login

curl -X POST https://terrar.360bulkmessenger.co.mz/v2/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "joao@empresa.co.mz",
    "password": "senha123"
  }'

Status de Mensagem

Status	Descricao
queued	Na fila para envio imediato
scheduled	Agendada para envio futuro (v2)
sent	Enviada com sucesso
delivered	Entregue ao destinatario
failed	Falhou apos todas as tentativas
cancelled	Agendamento cancelado (v2)

API de Notificacoes Multi-Canal

Canais Disponiveis

SMS

WhatsApp

Email