Início rápido

Envie sua primeira mensagem MorisBox em menos de cinco minutos.

1. Obter uma chave de API

O acesso ao sandbox do MorisBox é concedido por parceiro. Depois que sua organização for ativada:

1. Entre no Partner Hub → https://partner.morisbox.com
2. Abra Configurações → Chaves de API
3. Crie uma chave com o scope send (ou full para uma integração mais ampla)
4. Copie o segredo uma única vez; ele só é exibido durante a criação

Nunca inclua chaves de API em commits. Prefira variáveis de ambiente. Não compartilhe chaves entre organizações.

2. URL base

Sandbox (integrações de parceiros):

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

3. Enviar uma mensagem de texto

Substitua $SEED360_API_KEY pela chave do 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"
  }'

Use um telefone real de usuário final no formato E.164, vinculado (ou que será vinculado) ao seu parceiro.

Resposta bem-sucedida

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

A mensagem aparece no Application Client do usuário para o seu parceiro (hub / caixa de entrada), e não como uma conversa de suporte, a menos que você use a API de conversas.

4. Enviar uma imagem

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 uma 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>"
  }'

Em dispositivos móveis, o usuário abre a newsletter completa diretamente da lista do hub.

6. Próximos passos

Tema	Link
Autenticação e scopes	Autenticação
Todos os tipos de conteúdo	Mídia e tipos de conteúdo
Formulários interativos	Fluxos
Hosts do sandbox	Sandbox e Live
Não é parceiro?	Contas de desenvolvedor (somente modelos aprovados)
Formato de erro	Erros