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
- 1Crie a conta e confirme o email se for solicitado no registo.
- 2Entre no painel e confira os seus dados em O meu perfil.
- 3Contacte a equipa com o serviço, volume e sistema que pretende integrar.
- 4Confirme a proposta, os requisitos e o acesso antes de pagar ou enviar mensagens.
Conta e segurança
- 1Preencha nome, apelido, email, país, província, cidade, distrito e telemóvel sem indicativo. O indicativo é preenchido automaticamente.
- 2Defina a senha, repita-a e aceite os Termos e Condições. Use o olho para verificar a senha antes de confirmar.
- 3Entre com email e senha. A sessão mantém-se neste navegador; ao voltar ao início, escolha O meu painel.
- 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.
- 1Confirme a activação, o saldo contratado, o remetente autorizado e o formato dos números.
- 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.
- 3Configure a chave apenas no servidor da sua aplicação e faça um envio para um número de teste autorizado.
- 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çãoGET /api/v1/healthSem autenticaçãoPOST /api/v1/sendRequer X-API-Key1. Verificar disponibilidade sem enviar
curl --fail --max-time 15 https://server.tsemba.com/api/v1/healthA 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
toNúmero do destinatário no formato confirmado para o serviço.
fromRemetente autorizado; substitua REMETENTE_APROVADO pelo valor confirmado.
contentTexto da mensagem. Os três campos são obrigatórios.
# 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
{
"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.
200Pedido aceite
400Campos obrigatórios em falta
401Chave 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.
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.
- 1Indique à equipa o número empresarial, a empresa e o fluxo pretendido: notificações, atendimento ou integração.
- 2Confirme o direito de utilização do número, os consentimentos dos contactos e os requisitos do canal.
- 3Aguarde a confirmação do método de ligação, funcionalidades, limites e condições da subscrição.
- 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 APISender ID
- 1Envie à equipa o nome comercial pretendido e a identificação da empresa.
- 2Confirme os documentos, o tamanho permitido e os caracteres aceites antes do pedido.
- 3Aguarde a decisão e a confirmação do remetente autorizado. O pagamento não equivale a aprovação automática.
- 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 IDCompras 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.
- 1Contacte a equipa com quantidade de unidades ou serviço e os dados de facturação.
- 2Receba e confira a proposta e o montante final antes de confirmar o pagamento.
- 3Utilize apenas as instruções de pagamento confirmadas pela equipa e guarde o comprovativo.
- 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.
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