Inicio rápido

Envíe su primer mensaje de MorisBox en menos de cinco minutos.

1. Obtener una clave API

El acceso al sandbox de MorisBox se concede por socio. Una vez activada su organización:

1. Inicie sesión en el Partner Hub → https://partner.morisbox.com
2. Abra Ajustes → Claves API
3. Cree una clave con el scope send (o full para un trabajo de integración más amplio)
4. Copie el secreto una sola vez; solo se muestra al crearlo

Nunca incluya claves API en commits. Prefiera las variables de entorno. No comparta claves entre organizaciones.

2. URL base

Sandbox (integraciones de socios):

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

3. Enviar un mensaje de texto

Sustituya $SEED360_API_KEY por la clave del 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"
  }'

Utilice un teléfono real de usuario final en formato E.164, vinculado (o que vaya a vincularse) a su socio.

Respuesta correcta

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

El mensaje aparece en la aplicación cliente del usuario para su socio (hub / bandeja de entrada), no como una conversación de soporte, salvo que utilice la API de conversaciones.

4. Enviar una imagen

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. Enviar una 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>"
  }'

En dispositivos móviles, el usuario abre la newsletter completa directamente desde la lista del hub.

6. A continuación

Tema	Enlace
Autenticación y scopes	Autenticación
Todos los tipos de contenido	Medios y tipos de contenido
Formularios interactivos	Flows
Hosts del sandbox	Sandbox y Live
¿No es socio?	Cuentas de desarrollador (solo plantillas aprobadas)
Formato de error	Errores