Envoyer des messages

Envoyer une notification

POST /api/v1/dev/messages
Authorization: Bearer sk_dev_…
Content-Type: application/json

{
  "phone": "+228XXXXXXXX",
  "template_code": "notification",
  "lang": "fr",
  "channel": "inapp",
  "vars": {
    "text": "Bonjour depuis mon application"
  },
  "priority": "notification",
  "idempotency_key": "order-42-notify"
}

Champ	Obligatoire	Description
`phone`	oui	E.164
`template_code`	oui	Code d'un modèle approuvé (`GET /dev/templates`)
`lang`	non	Défaut `fr`
`channel`	non	`inapp`, `sms`, `whatsapp` (sinon premier modèle trouvé)
`vars`	non	Variables `{{…}}` du modèle
`priority`	non	Défaut `notification`
`idempotency_key`	non	Déduplication par développeur

Erreurs fréquentes

Code	Cause
`validation`	`template_code` manquant
`not_found`	Modèle non approuvé / inconnu
`dlp_blocked`	Contenu bloqué par la DLP plateforme
`blocked`	Compte utilisateur en opt-out

Refus d'envoi libre

{
  "error": {
    "code": "validation",
    "message": "template_code is required. Developers may only send approved MorisBox templates."
  }
}

Historique

GET /api/v1/dev/messages?limit=50
GET /api/v1/dev/messages?phone=%2B228XXXXXXXX

Chaque message porte notamment :

developer_id: votre compte
template_code
state, channel, body rendu, deliveries

curl

export API=https://api.morisbox.com/api/v1
export KEY=sk_dev_…

curl -sS -X POST "$API/dev/messages" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "template_code": "notification",
    "lang": "fr",
    "channel": "inapp",
    "vars": { "text": "Votre dossier a été mis à jour." }
  }'