Démarrage rapide

Envoyez votre premier message MorisBox en moins de cinq minutes.

1. Obtenir une clé API

L'accès sandbox MorisBox est accordé par partenaire. Une fois votre organisation activée :

Connectez-vous au Partner Hub → https://partner.morisbox.com
Ouvrez Paramètres → Clés API
Créez une clé avec le scope send (ou full pour un travail d'intégration plus large)
Copiez le secret une seule fois - il n'est affiché qu'à la création

Ne commitez jamais les clés API. Préférez les variables d'environnement. Ne partagez pas les clés entre organisations.

2. Base URL

Sandbox (intégrations partenaires) :

https://api.morisbox.com/api/v1

3. Envoyer un message texte

Remplacez $SEED360_API_KEY par la clé du Partner Hub.

export SEED360_API_BASE="https://api.morisbox.com/api/v1"
export SEED360_API_KEY="sk_…"   # clé partenaire

curl -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "body": "Bienvenue sur MorisBox",
    "priority": "notification"
  }'

Utilisez un vrai téléphone utilisateur final en E.164 rattaché (ou qui sera rattaché) à votre partenaire.

Réponse de succès

{
  "message_id": 123,
  "ref": "a1b2c3…",
  "phone": "+228XXXXXXXX",
  "content_type": "text",
  "body": "Bienvenue sur MorisBox",
  "state": "delivered"
}

Le message apparaît dans l'Application Client de l'utilisateur pour votre partenaire (hub / boîte de réception), pas comme une conversation support sauf si vous utilisez l'API conversations.

4. Envoyer une image

curl -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "content_type": "image",
    "body": "Photo de l’agence",
    "media_url": "https://example.com/photo.jpg",
    "media_filename": "agence.jpg"
  }'

5. Envoyer une newsletter HTML

curl -X POST "$SEED360_API_BASE/messages" \
  -H "Authorization: Bearer $SEED360_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+228XXXXXXXX",
    "content_type": "html",
    "subject": "Infos · Juillet",
    "html": "<h1>Bonjour</h1><p>Votre newsletter…</p>"
  }'

Sur mobile, l'utilisateur ouvre la newsletter complète directement depuis la liste hub.

6. Ensuite

Sujet	Lien
Auth et scopes	Authentication
Tous les types de contenu	Médias et types de contenu
Formulaires interactifs	Flows
Hôtes sandbox	Sandbox et Live
Pas partenaire ?	Comptes développeurs (modèles approuvés uniquement)
Format d'erreur	Erreurs