Conceitos principais

Contas

Uma conta é um usuário final identificado por um número de telefone E.164 (+228…).

Status	Significado
`pending`	Convidado / ainda não totalmente verificado
`claimed`	O usuário concluiu a verificação por OTP e pode usar o aplicativo
`blocked`	Descadastrado / bloqueado

Os parceiros vinculam contas a si mesmos (M2M ou campos do provedor). Os usuários vinculados veem esse parceiro no seu hub.

Um parceiro é uma organização (por exemplo, SEED) com:

As mensagens de parceiro → usuário podem ser:

Tipo	Comportamento no hub
Texto, mídia, link, HTML	Mensagens de hub independentes (lista, as mais recentes primeiro)
Convites para fluxos	Cartões de fluxo independentes
Respostas de suporte	Dentro de uma conversa iniciada pelo usuário

A API para parceiros POST /messages cria mensagens do hub, não conversas de suporte.

`content_type`	Descrição
`text`	Texto simples
`image`	URL de imagem ou base64
`document`	PDF / arquivos
`audio`	Arquivo de áudio
`video`	Arquivo de vídeo
`link`	Cartão CTA (url + label + title)
`html`	Newsletter móvel (HTML)
`flow`	Convite para um formulário interativo com várias etapas
`system`	Mensagem do sistema da plataforma

As conversas são interações de suporte:

São criadas quando um usuário inicia uma solicitação de suporte
Os agentes respondem pelo Partner Hub / API de agente
As sessões de bot podem usar assuntos como Bot · … (ocultos no menu «Conversas» do usuário)

São configurados por parceiro como uma cadeia ordenada, por exemplo:

Os OTPs e as mensagens críticas podem forçar um subconjunto de canais.

Catálogo completo das superfícies do cliente, das ferramentas para parceiros e do comportamento dos canais: Plataformas.

Informe idempotency_key no envio para evitar duplicatas durante novas tentativas:

{ "idempotency_key": "partner-order-98765" }

O mesmo parceiro + a mesma chave retorna a mensagem original.