SDKs oficiais

Integre a MozeSMS em minutos

Bibliotecas oficiais para PHP e JavaScript / React. Envie SMS, verifique OTP, consulte o saldo e recarregue, sem escrever chamadas HTTP à mão.

$ composer require woomoza/mozesms-php
Installing woomoza/mozesms-php (v1.0.2)
Generating autoload files
$ php vendor/bin/mozesms send 846000000 "Olá da MozeSMS!"
enviado +258846000000
custo1.35 MT
saldo119.15 MT
woomoza/mozesms-php · v1.0.2api.mozesms.com

Escolha a sua linguagem

Gratuitos e de código aberto (MIT). As chaves (API Key e Secret) criam-se em Gestão de API no seu painel.

PHP

PHP 7.4+ · sem dependências além de curl

Cliente completo para PHP puro, Laravel, Symfony ou WordPress. Inclui um comando mozesms para testar pelo terminal.

composer require woomoza/mozesms-php

JavaScript / React

Node 18+ · TypeScript · Next.js

Cliente para o seu servidor, mais um handler seguro e hooks de React (useOtp, useSendSms) para o browser.

npm install @woomoza/mozesms

Do zero ao primeiro SMS

Três linhas para enviar, três para verificar um código.

use MozeSMS\Client;

$moze = new Client(getenv('MOZESMS_KEY'), getenv('MOZESMS_SECRET'));

$moze->sms->send('846000000', 'Olá da MozeSMS!', 'MozeSMS');

// Verificação por OTP
$sessao = $moze->otp->send('846000000');
$certo  = $moze->otp->check($sessao['session_id'], $codigoDoUtilizador);   // true | false
import { MozeSMS } from '@woomoza/mozesms';

const moze = new MozeSMS({ apiKey: process.env.MOZESMS_KEY, apiSecret: process.env.MOZESMS_SECRET });

await moze.sms.send('846000000', 'Olá da MozeSMS!', 'MozeSMS');

// Verificação por OTP
const sessao = await moze.otp.send('846000000');
const certo  = await moze.otp.check(sessao.session_id, codigoDoUtilizador);   // true | false
// 1) servidor (ex.: Next.js, app/api/mozesms/route.ts): só ele conhece o secret
export const POST = createHandler({ client, otp: { sender_id: 'MINHALOJA' } });

// 2) browser: um hook, sem credenciais
const otp = useOtp();
await otp.send('+258 84 600 0000');           // envia o código
const certo = await otp.verify('123456');   // true | false

O que os SDKs já fazem por si

Para que a integração fique certa à primeira.

SMS e OTP completos

Envio simples, em massa e agendado; OTP com envio, verificação e reenvio.

Não paga por erros

Números inválidos são recusados antes do pedido, para não gastar saldo à toa.

Sem envios duplicados

Um envio nunca é repetido automaticamente, por isso não é cobrado duas vezes.

Erros claros

Saldo insuficiente, limite de pedidos, sem rede: cada caso tem o seu erro.

Webhooks verificados

Confirme a assinatura dos avisos de entrega com uma chamada.

Conta e recargas

Saldo, Sender ID, faturas e recargas M-Pesa, e-Mola, banco ou PayPal.

O secret fica no seu servidor

Num site React, tudo o que corre no browser é visível. Por isso os hooks falam com uma rota sua, e só essa rota usa a chave e o secret.

A rota de exemplo só permite enviar e verificar OTP, com limites por número e por IP, para ninguém gastar o seu saldo.

Browser (React) O seu servidor api.mozesms.com

Perguntas frequentes

Os SDKs têm custo?

Não. São gratuitos e de código aberto (licença MIT). Paga apenas os SMS que enviar, ao preço do seu plano.

Posso usar o SDK diretamente no browser?

Não, e o SDK recusa-se a arrancar lá: o API Secret ficaria visível a qualquer pessoa. Use o cliente no servidor e os hooks de React no browser.

Os SDKs apagam dados?

Não. Só criam, consultam e atualizam. Para apagar algo, use o painel. É uma proteção para o caso de uma chave ser roubada.

E se a minha linguagem não está na lista?

Pode usar a API REST diretamente, com exemplos em várias linguagens na referência da API.

Onde obtenho a API Key e o Secret?

No painel, em Gestão de API. Pode dar um nome a cada token, limitar os IPs que o podem usar e definir uma data de validade.

Pronto para integrar?

Crie as suas chaves e envie o primeiro SMS em poucos minutos.