Guias e referência técnica

Documentação MozSend

Conta, SMS, WhatsApp, Sender ID e facturação: requisitos, percursos e referência dos serviços disponíveis.

Começar

Criar uma conta não activa automaticamente um serviço de mensagens. O acesso ao perfil está disponível; a contratação e o acesso técnico são confirmados separadamente.

Registo, login e perfil

Disponível

Gestão de contas pelo super administrador

Disponível

API SMS do serviço provisionado

Requer activação e credencial própria

Envio SMS no painel e chaves de cliente

Ainda não disponível

WhatsApp, sessões e eventos

Activação técnica por confirmar

Pagamento online e saldo no painel

Ainda não disponível

  1. 1Crie a conta e confirme o email se for solicitado no registo.
  2. 2Entre no painel e confira os seus dados em O meu perfil.
  3. 3Contacte a equipa com o serviço, volume e sistema que pretende integrar.
  4. 4Confirme a proposta, os requisitos e o acesso antes de pagar ou enviar mensagens.
Solicitar activação

Conta e segurança

  1. 1Preencha nome, apelido, email, país, província, cidade, distrito e telemóvel sem indicativo. O indicativo é preenchido automaticamente.
  2. 2Defina a senha, repita-a e aceite os Termos e Condições. Use o olho para verificar a senha antes de confirmar.
  3. 3Entre com email e senha. A sessão mantém-se neste navegador; ao voltar ao início, escolha O meu painel.
  4. 4Para terminar a sessão, seleccione Sair no painel. Em dispositivos partilhados, termine sempre a sessão.

A conta pessoal mostra o próprio perfil. A administração está reservada a contas autorizadas e não é atribuída no formulário de registo.

Na recuperação, indique o email da conta e abra a ligação recebida. Defina e confirme a nova senha. Uma ligação expirada exige um novo pedido.

Nunca partilhe senhas, tokens de sessão, PINs ou chaves API. Uma senha de login não serve como chave de envio SMS.

SMS

O envio pelo painel ainda não está activo. Para integração, utilize apenas o acesso técnico do serviço SMS que a equipa tenha provisionado para si.

  1. 1Confirme a activação, o saldo contratado, o remetente autorizado e o formato dos números.
  2. 2Prepare um destinatário com indicativo internacional e uma mensagem autorizada pelo destinatário. Para Moçambique, o exemplo de formato é 258 seguido do número local.
  3. 3Configure a chave apenas no servidor da sua aplicação e faça um envio para um número de teste autorizado.
  4. 4Guarde o message_id devolvido. Este identificador confirma a aceitação do pedido, não a entrega nem a leitura.

O contrato actual aceita um destinatário por pedido. Envios em massa, agendamento, importação de contactos e cobrança por segmentos não estão implementados no painel; confirme condições antes de preparar uma campanha.

Mensagens longas, acentos e emojis podem exigir múltiplos segmentos SMS. Confirme o critério de consumo com a equipa; não assuma que uma mensagem corresponde sempre a uma unidade.

API de SMS

Esta referência descreve o serviço SMS provisionado, não uma API da conta MozSend. O painel não emite chaves de cliente. Utilize os exemplos apenas depois de receber uma credencial autorizada e confirmar o remetente.

URL base do serviço SMS
https://server.tsemba.com
Autenticação do envio
X-API-Key: $SMS_API_KEY

Guarde SMS_API_KEY e SMS_API_BASE_URL no ambiente privado do seu servidor. Não inclua a chave no JavaScript do navegador, numa aplicação pública ou no endereço do pedido.

GET /Sem autenticação
GET /api/v1/healthSem autenticação
POST /api/v1/sendRequer X-API-Key

1. Verificar disponibilidade sem enviar

Verificação sem consumo de SMS
curl --fail --max-time 15 https://server.tsemba.com/api/v1/health

A resposta de saúde pode indicar status: ok e jasmin: reachable. Isto verifica a ligação técnica; não confirma saldo, remetente aprovado ou entrega. A disponibilidade pode mudar.

2. Preparar o pedido de envio

to

Número do destinatário no formato confirmado para o serviço.

from

Remetente autorizado; substitua REMETENTE_APROVADO pelo valor confirmado.

content

Texto da mensagem. Os três campos são obrigatórios.

POST /api/v1/send · envio real após activação
# SMS_API_KEY: chave do serviço activado, nunca a senha da conta.
export SMS_API_BASE_URL="https://server.tsemba.com"
curl --request POST "$SMS_API_BASE_URL/api/v1/send" \
  --header "X-API-Key: $SMS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"to":"258840000000","from":"REMETENTE_APROVADO","content":"Mensagem de teste"}'

Executar o exemplo de envio pode consumir créditos e contactar o destinatário. Substitua o número e o remetente, confirme autorização e não execute com os valores de demonstração.

3. Interpretar a resposta

HTTP 200 · campo de resposta documentado
{
  "message_id": "IDENTIFICADOR_DEVOLVIDO"
}

A resposta pode conter outros campos. Guarde message_id para suporte, mas não marque a mensagem como entregue. O serviço não expõe consulta de mensagem por ID.

200

Pedido aceite

400

Campos obrigatórios em falta

401

Chave inválida

Não foi confirmado suporte a idempotência. Se um pedido expirar depois de submetido, não repita automaticamente: pode duplicar o envio. Verifique a ocorrência com a equipa.

WhatsApp

Ainda não existe um contrato de API WhatsApp validado nem criação de instâncias no painel. Não há endpoints, códigos QR ou webhooks de WhatsApp disponíveis para utilização nesta versão.

  1. 1Indique à equipa o número empresarial, a empresa e o fluxo pretendido: notificações, atendimento ou integração.
  2. 2Confirme o direito de utilização do número, os consentimentos dos contactos e os requisitos do canal.
  3. 3Aguarde a confirmação do método de ligação, funcionalidades, limites e condições da subscrição.
  4. 4Só depois da activação técnica, teste envio, recepção, reconexão e eventos com os detalhes fornecidos pela equipa.

Não presumimos uma janela de atendimento, aprovação de modelos, limite de sessões ou envio de ficheiros sem confirmar o serviço contratado. As regras aplicáveis do WhatsApp devem ser respeitadas.

Solicitar WhatsApp API

Sender ID

  1. 1Envie à equipa o nome comercial pretendido e a identificação da empresa.
  2. 2Confirme os documentos, o tamanho permitido e os caracteres aceites antes do pedido.
  3. 3Aguarde a decisão e a confirmação do remetente autorizado. O pagamento não equivale a aprovação automática.
  4. 4Utilize no campo from apenas o remetente confirmado para a sua conta de serviço.

A taxa de Sender ID é única e o envio de SMS é cobrado separadamente. Não é possível solicitar, aprovar ou alterar remetentes automaticamente neste painel.

Solicitar Sender ID

Compras e facturação

SMS
0,75 MTPor unidade SMS
WhatsApp API
250,00 MTMensalidade
Sender ID
600,00 MTTaxa única

A compra mínima de SMS é de 250 unidades. Os valores apresentados são preços base; os impostos são incluídos na facturação.

  1. 1Contacte a equipa com quantidade de unidades ou serviço e os dados de facturação.
  2. 2Receba e confira a proposta e o montante final antes de confirmar o pagamento.
  3. 3Utilize apenas as instruções de pagamento confirmadas pela equipa e guarde o comprovativo.
  4. 4Aguarde confirmação de pagamento e activação. Não existe crédito automático de saldo neste painel.

Os logótipos de pagamentos no rodapé não são um checkout. Não há processamento online activo, débitos automáticos ou confirmação de pagamento por webhook nesta versão.

Facturação, Cancelamentos e Reembolsos

Webhooks e relatórios

O serviço SMS documentado não expõe relatórios de entrega (DLR), mensagens recebidas, consulta de saldo ou pesquisa por message_id. Não configure um webhook ou uma rota de consulta que não lhe tenha sido fornecida.

Os eventos WhatsApp e os eventos de pagamento também não estão activos nesta versão. O painel não apresenta um histórico de envios ou relatórios de consumo.

Quando eventos forem disponibilizados, a integração deverá validar a assinatura, proteger os dados, tratar duplicados e registar falhas. Não aceite callbacks como prova de pagamento ou entrega sem validação.

Resolução de problemas

Não consigo entrar

Confirme email e senha, verifique se foi pedida confirmação do email e use Recuperar senha. Não envie a sua senha ao suporte.

Recebo HTTP 401 no envio

Confirme a chave do serviço activado e o cabeçalho X-API-Key. O login do painel e a senha não autorizam pedidos de SMS.

Recebo HTTP 400 no envio

Envie JSON válido com to, from e content e Content-Type: application/json. Não remova nenhum dos três campos obrigatórios.

O pedido expirou ou o servidor não responde

Verifique a rede e o endpoint de saúde. Um timeout não prova que o pedido foi rejeitado; evite repetir o envio sem verificar a ocorrência.

Tenho message_id, mas não recebi o SMS

A aceitação não comprova entrega. Envie ao suporte o identificador, a hora e o remetente utilizado, sem a chave API ou dados desnecessários.

Não encontro saldo, QR ou chaves no painel

Estas funções ainda não estão disponíveis. Consulte a equipa para confirmar o acesso do serviço contratado.

Para suporte, indique serviço, data e hora com fuso, código HTTP e message_id quando existir. Oculte credenciais e limite os dados pessoais partilhados.

info@mozsend.com