Documentazione API

Base URL: https://apimassive.com/api/v1

Autenticazione

Per l'invio diretto usa la tua API key (area Account) come Bearer token. Per gli endpoint di campagna usa l'ingest token della campagna.

Authorization: Bearer API_KEY

Trigger di campagna (usato dal tuo CRM)

POST /api/v1/trigger/{ingest_token}

curl -X POST https://apimassive.com/api/v1/trigger/ing_xxx \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ing_xxx" \
  -d '{
    "customer": { "phone": "+391234567890", "name": "Mario" },
    "order":    { "id": "ORD-1001", "total": "49.90" }
  }'

La piattaforma applica la mappatura campi e il template configurati dalla campagna e invia il messaggio.

Invio diretto

POST /api/v1/messages

curl -X POST https://apimassive.com/api/v1/messages \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "sms",
    "provider": "nexa",
    "to": "+391234567890",
    "text": "Hello! Your order is confirmed."
  }'

Stato messaggio

GET  /api/v1/messages/{id}     (Bearer API key)
GET  /api/v1/balance
GET  /api/v1/health

Delivery report (webhook provider)

POST /api/v1/dlr/{provider} — ricevuto dai provider (Twilio, NEXA) e inoltrato al callback_url della campagna.