SMS
SMS
Envio e consulta de mensagens SMS.
https://mex10.com/api/shortcodeV2.aspx
Autenticação Token MEX10 + IP autorizado
Método principal GET por query string
Resposta JSON
Endpoint https://mex10.com/api/shortcodeV2.aspx
Operações disponíveis
Envia uma mensagem SMS e retorna um identificador único para consultas posteriores.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
send
n
Condicional
Número do destinatário. Exemplo brasileiro com DDD.
11981327755
m
Condicional
Conteúdo da mensagem.
Mensagem de teste MEX10
schedule
Não
Agendamento no formato `yyyy-MM-dd HH:mm:ss`. Se vazio no SMS, a API usa a data/hora atual.
2026-09-21 15:30:00
flash
Não
Quando `1`, o envio SMS utiliza prioridade 1; caso contrário, prioridade 0.
0
Exemplo de requisição Copiar
https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=send&n=11981327755&m=Mensagem%20de%20teste
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"sms": {
"code": "5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0",
"status": "PENDENTE",
"date": "2026-09-21 11:30:00"
}
}
Observações O número pode ser enviado com formatação; espaços, hífens, parênteses e o sinal de + são removidos. Quando `schedule` não é informado, o envio utiliza a data e hora atuais. `flash=1` utiliza a prioridade disponível para esse tipo de envio.
Retorna os saldos disponíveis da conta e, quando houver, o histórico de pagamentos.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
saldo
Exemplo de requisição Copiar
https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=saldo
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"balances": {
"sms": 15000,
"email": 2500,
"voz": 300
},
"historypayments": [
{
"data": "20/09/2026 14:10:00",
"totalsms": 10000,
"preco": 0.05
}
]
}
Observações Contas sem saldo SMS disponível podem receber `SEM_SALDO`.
Consulta o status de uma mensagem pelo `code` retornado no envio.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
status
code
Condicional
Identificador retornado no envio e usado para consulta.
5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0
Exemplo de requisição Copiar
https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=status&code=5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"status": {
"code": "5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0",
"status": "ENTREGUE",
"date": "2026-09-21 00:00:00"
}
}
Observações Se o identificador não for localizado, retorna `CODE_NOT_FOUND`.
Consulta o status detalhado da mensagem e inclui o campo `status_operadora`.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
status2
code
Condicional
Identificador retornado no envio e usado para consulta.
5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0
Exemplo de requisição Copiar
https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=status2&code=5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"status": {
"code": "5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0",
"status": "ENTREGUE",
"date": "2026-09-21 11:30:22",
"status_operadora": "ENTREGUE"
}
}
Observações Status possíveis incluem `PENDENTE`, `ENVIADO`, `ENTREGUE` e `ERRO`.
Lista respostas SMS recebidas dentro de um período, com filtro opcional por número.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
response
datainicial
Condicional
Data inicial para consulta de respostas.
2026-09-01
datafinal
Condicional
Data final para consulta de respostas.
2026-09-21
numero
Não
Filtro opcional por número em `response`.
11981327755
Exemplo de requisição Copiar
https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=response&datainicial=2026-09-01&datafinal=2026-09-21&numero=11981327755
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"response": [
{
"Data": "2026-09-21 10:15:00",
"Numero": "+5511981327755",
"Mensagem": "SIM"
}
]
}
Observações Utilize `YYYY-MM-DD` em `datainicial` e `datafinal`. O parâmetro `numero` é opcional.
Retorna a quantidade de mensagens pendentes na fila de envio.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
queue
Exemplo de requisição Copiar
https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=queue
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"queue": "42"
}
Observações O valor de `queue` é retornado como string.
Cancela as mensagens pendentes da fila de SMS da conta.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
cancelqueue
Exemplo de requisição Copiar
https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=cancelqueue
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"lines": "42"
}
Observações `lines` informa a quantidade de mensagens alteradas e é retornado como string.
Retorna os números presentes na blacklist SMS da conta.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
blacklist
Exemplo de requisição Copiar
https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=blacklist
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"blacklist": [
{
"Data": "2026-09-20 18:00:00",
"Numero": "11981327755",
"Palavra": "SAIR"
}
]
}
RCS
RCS
Envio de mensagens RCS com Rich Card, imagem e ação por link.
https://mex10.com/api/rcs.aspx
Autenticação Token MEX10 + IP autorizado
Método principal GET por query string
Resposta JSON
Endpoint https://mex10.com/api/rcs.aspx
Operações disponíveis
Envia uma mensagem RCS em formato Rich Card com texto, imagem e link opcional.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
send
n
Condicional
Número do destinatário. Exemplo brasileiro com DDD.
11981327755
m
Condicional
Conteúdo da mensagem.
Mensagem de teste MEX10
image
Não
URL da imagem do Rich Card RCS.
https://cdn.cliente.com/banner.jpg
link
Não
URL da ação/CTA do RCS. Se vazio, a API padrão tenta extrair a primeira URL de `m`.
https://cliente.com/oferta
Exemplo de requisição Copiar
https://mex10.com/api/rcs.aspx?token=SEU_TOKEN_MEX10&t=send&n=11981327755&m=Conheca%20nossa%20oferta&image=https%3A%2F%2Fcdn.cliente.com%2Fbanner.jpg&link=https%3A%2F%2Fcliente.com%2Foferta
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"rcs": {
"code": "5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0",
"status": "PENDENTE",
"date": "2026-09-21 11:30:00"
}
}
Observações O número deve corresponder a um celular brasileiro válido com DDD. Se `link` estiver vazio e `m` contiver uma URL HTTP/HTTPS, a primeira URL pode ser utilizada como ação do card. Quando há link, o CTA padrão exibido é `Clique aqui!`. Emojis e símbolos não suportados podem ser removidos do texto.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
saldo
Exemplo de requisição Copiar
https://mex10.com/api/rcs.aspx?token=SEU_TOKEN_MEX10&t=saldo
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"balances": {
"sms": 15000,
"email": 2500,
"whatsapp": 0
}
}
Consulta o status de uma mensagem RCS pelo `code` retornado no envio.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
status
code
Condicional
Identificador retornado no envio e usado para consulta.
5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0
Exemplo de requisição Copiar
https://mex10.com/api/rcs.aspx?token=SEU_TOKEN_MEX10&t=status&code=5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"status": {
"code": "5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0",
"status": "ENTREGUE",
"date": "2026-09-21 11:30:00"
}
}
Observações Se o identificador não for localizado, retorna `CODE_NOT_FOUND`. O campo `date` representa a data e hora da consulta.
Voz
Voice
Chamadas de voz utilizando arquivo de áudio MP3.
https://mex10.com/api/voice.aspx
Autenticação Token MEX10 + IP autorizado
Método principal GET para chamadas e consultas · POST para upload
Resposta JSON
Endpoint https://mex10.com/api/voice.aspx
Operações disponíveis
Inicia uma chamada de voz utilizando uma URL pública de arquivo MP3.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
send
n
Condicional
Número do destinatário. Exemplo brasileiro com DDD.
11981327755
audio
Condicional
URL pública do arquivo MP3 usado na chamada de voz.
https://cdn.cliente.com/audio.mp3
Exemplo de requisição Copiar
https://mex10.com/api/voice.aspx?token=SEU_TOKEN_MEX10&t=send&n=11981327755&audio=https%3A%2F%2Fcdn.cliente.com%2Faudio.mp3
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"voice": {
"code": "123456",
"status": "DIAL",
"date": "2026-09-21 11:30:00"
}
}
Observações O número pode ser enviado com formatação e é normalizado para o envio. O `code` retornado identifica a chamada e deve ser utilizado na consulta de status.
Retorna os saldos disponíveis da conta, incluindo o saldo de voz.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
saldo
Exemplo de requisição Copiar
https://mex10.com/api/voice.aspx?token=SEU_TOKEN_MEX10&t=saldo
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"balances": {
"sms": 15000,
"email": 2500,
"voz": 300
}
}
Consulta o status de uma chamada de voz pelo `code` retornado no envio.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
status
code
Condicional
Identificador retornado no envio e usado para consulta.
123456
Exemplo de requisição Copiar
https://mex10.com/api/voice.aspx?token=SEU_TOKEN_MEX10&t=status&code=123456
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"status": {
"code": "123456",
"status": "ANSWERED",
"duration": "32",
"date": "2026-09-21 11:30:00"
}
}
Observações Quando ainda não existe status final, a chamada pode retornar `DIAL`. A resposta inclui a duração da chamada em `duration`.
Disponibiliza um arquivo MP3 para uso nas chamadas de voz.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
upload
file
Condicional
Primeiro arquivo multipart/form-data. Somente `.mp3` é aceito.
audio.mp3
filebase64
Condicional
Arquivo MP3 em Base64. Aceita Base64 puro ou data URI.
SUQzBAAAAA...
filename
Condicional
Nome do arquivo no modo Base64 ou URL HTTP/HTTPS para o modo de download remoto.
audio.mp3
Exemplo cURL Copiar
# Multipart
curl -X POST "https://mex10.com/api/voice.aspx" \
-F "token=SEU_TOKEN_MEX10" -F "t=upload" -F "file=@audio.mp3"
# Base64
curl -X POST "https://mex10.com/api/voice.aspx" \
-H "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode "token=SEU_TOKEN_MEX10" --data-urlencode "t=upload" \
--data-urlencode "filename=audio.mp3" \
--data-urlencode "filebase64=SUQzBAAAAA..."
# URL remota
curl -X POST "https://mex10.com/api/voice.aspx" \
-H "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode "token=SEU_TOKEN_MEX10" --data-urlencode "t=upload" \
--data-urlencode "filename=https://cdn.cliente.com/audio.mp3"
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"upload": {
"filename": "4c0a8f..._3f42a1b2c3d4e5f.mp3",
"url": "https://mex10.com/deadpool/dados/4c0a8f..._3f42a1b2c3d4e5f.mp3"
}
}
Observações Somente arquivos `.mp3` são aceitos. O áudio pode ser enviado por multipart/form-data, Base64 ou por URL HTTP/HTTPS.
Voz / Envio em massa
VoiceBulk
Envie chamadas de voz em lote com um único POST JSON. Informe uma URL de áudio MP3 e até 500 números; a API retorna o identificador de cada chamada registrada.
POST application/json Até 500 números Códigos individuais
https://mex10.com/api/voicebulk.aspx
Autenticação Token MEX10 + IP autorizado
Método principal POST · application/json
Resposta JSON com array de códigos individuais
Endpoint https://mex10.com/api/voicebulk.aspx
Como funciona: o arquivo MP3 é utilizado por todas as chamadas do lote. A operação registra os números para processamento, e cada inserção bem-sucedida retorna seu próprio code com o status inicial DIAL.
Operações disponíveis
Registra até 500 chamadas em uma única requisição, com o mesmo áudio MP3. A resposta preserva a ordem dos números recebidos e associa cada número ao seu identificador interno (cod_voz).
Parâmetros do corpo JSON
Parâmetro Tipo Obrigatório Descrição Exemplo
tokenstring Sim Token de autenticação fornecido pela MEX10. O IP de origem também precisa estar autorizado. SEU_TOKEN_MEX10
tstring Sim Identifica a operação de envio em massa. Envie sempre sendbulk. sendbulk
audiostring (URL) Sim Endereço HTTP/HTTPS público do áudio MP3, acessível pelo servidor. O mesmo áudio será utilizado em todo o lote. https://cdn.cliente.com/audio.mp3
numbersarray Sim Lista de 1 a 500 números brasileiros com DDD. Prefira strings, para preservar os dígitos. Aceita DDD + número com 10 ou 11 dígitos; o prefixo 55 pode ser informado. ["11999990001", "11999990002"]
Exemplo de requisição · POST JSON Copiar
POST https://mex10.com/api/voicebulk.aspx
Content-Type: application/json
{
"token": "SEU_TOKEN_MEX10",
"t": "sendbulk",
"audio": "https://cdn.cliente.com/audio.mp3",
"numbers": [
"11999990001",
"11999990002",
"11999990003",
"11999990004",
"11999990005"
]
}
Exemplo cURL Copiar
curl --request POST "https://mex10.com/api/voicebulk.aspx" \
--header "Content-Type: application/json" \
--data-raw '{
"token": "SEU_TOKEN_MEX10",
"t": "sendbulk",
"audio": "https://cdn.cliente.com/audio.mp3",
"numbers": [
"11999990001",
"11999990002",
"11999990003"
]
}'
Exemplo em JavaScript (fetch)
Requisição com JSON.stringify Copiar
const resposta = await fetch("https://mex10.com/api/voicebulk.aspx", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
token: "SEU_TOKEN_MEX10",
t: "sendbulk",
audio: "https://cdn.cliente.com/audio.mp3",
numbers: ["11999990001", "11999990002", "11999990003"]
})
});
const dados = await resposta.json();
console.log(dados.voicebulk?.codes);
Exemplo de resposta · sucesso Copiar
{
"data": {
"success": true,
"date": "2026-11-11 13:20:00"
},
"errors": {
"error": false,
"description": ""
},
"voicebulk": {
"total": 3,
"inserted": 3,
"failed": 0,
"codes": [
{
"number": "11999990001",
"date": "2026-11-11 13:20:00",
"code": "852001",
"status": "DIAL"
},
{
"number": "11999990002",
"date": "2026-11-11 13:20:00",
"code": "852002",
"status": "DIAL"
},
{
"number": "11999990003",
"date": "2026-11-11 13:20:00",
"code": "852003",
"status": "DIAL"
}
]
}
}
Entendendo a resposta
voicebulk.total: quantidade de números recebidos e validados para o lote.
voicebulk.inserted: quantidade efetivamente inserida na fila.
voicebulk.failed: quantidade de inserções que falharam.
voicebulk.codes: array com number, date, code e status de cada número.
status = DIAL significa chamada registrada para processamento, não chamada atendida ou concluída.
Os identificadores exibidos nos exemplos são ilustrativos. O código real é atribuído individualmente pela API.
Exemplo de resposta · sucesso parcial
Quando apenas algumas inserções falham, as chamadas registradas continuam válidas. Os números que falharam retornam status = ERROR e code = null.
Resposta com falha em um número Copiar
{
"data": {
"success": false,
"date": "2026-11-11 13:20:00"
},
"errors": {
"error": true,
"description": "PARTIAL_FAILURE"
},
"voicebulk": {
"total": 3,
"inserted": 2,
"failed": 1,
"codes": [
{
"number": "11999990001",
"date": "2026-11-11 13:20:00",
"code": "852001",
"status": "DIAL"
},
{
"number": "11999990002",
"date": "2026-11-11 13:20:00",
"code": null,
"status": "ERROR"
},
{
"number": "11999990003",
"date": "2026-11-11 13:20:00",
"code": "852003",
"status": "DIAL"
}
]
}
}
Validações e erros comuns
Descrição do erro Quando pode ocorrer
METHOD_NOT_ALLOWEDO envio não utilizou o método POST.
NUMBERS_FORMAT_INVALIDO array de números não pôde ser interpretado.
NUMBERS_LIMIT_1_TO_500O lote contém menos de 1 ou mais de 500 números.
INVALID_NUMBERUm dos números contém caracteres inválidos.
INVALID_NUMBER_LENGTHUm dos números não tem 10 ou 11 dígitos após a normalização.
AUDIO_URL_INVALIDA URL do áudio está ausente ou não é HTTP/HTTPS válida.
AUDIO_DOWNLOAD_FAILEDO servidor não conseguiu obter o arquivo de áudio.
INSUFFICIENT_VOICE_BALANCEO saldo de voz é menor que a quantidade solicitada.
PARTIAL_FAILUREUma ou mais inserções falharam, mas outras foram registradas.
TOKEN_INVALID, CODE_INVALID, SEM_SALDOFalhas de autenticação/autorização ou ausência de saldo na conta.
Observações de integração
Para enviar, utilize Body → raw → JSON no Postman, com o cabeçalho Content-Type: application/json.
A API normaliza formatações usuais de telefone e remove o DDI brasileiro 55 quando aplicável.
Se o mesmo número aparecer duas vezes no array, cada ocorrência é tratada como uma entrada distinta.
É necessário saldo de voz suficiente para todo o lote. Não há garantia de reserva atômica de saldo entre requisições simultâneas.
A URL do áudio deve permanecer acessível no momento do processamento da requisição. O arquivo é compartilhado entre as chamadas do lote.
Guarde cada code retornado para consultar a evolução individual da chamada.
Consultas e operações complementares
Os códigos retornados pelo sendbulk identificam registros de voz, como no envio individual. Para consultar o andamento de cada ligação, utilize a operação t=status da API Voice , passando o code específico. Para obter uma URL pública de MP3, consulte Upload de áudio MP3 ; para verificar créditos, Consultar saldo de voz .
Exemplo de consulta do status de um código retornado Copiar
GET https://mex10.com/api/voice.aspx?token=SEU_TOKEN_MEX10&t=status&code=852001
Voz
Voice + Callback
Chamadas de voz com callback associado à chamada.
https://mex10.com/api/voicecallback.aspx
Autenticação Token MEX10 + IP autorizado
Método principal GET para chamadas e consultas · POST para upload
Resposta JSON
Endpoint https://mex10.com/api/voicecallback.aspx
Operações disponíveis
Inicia uma chamada de voz e associa uma URL de callback à chamada.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
send
n
Condicional
Número do destinatário. Exemplo brasileiro com DDD.
11981327755
audio
Condicional
URL pública do arquivo MP3 usado na chamada de voz.
https://cdn.cliente.com/audio.mp3
callback
Não
URL que receberá os eventos associados à chamada.
https://cliente.com/callback/voz
Exemplo de requisição Copiar
https://mex10.com/api/voicecallback.aspx?token=SEU_TOKEN_MEX10&t=send&n=11981327755&audio=https%3A%2F%2Fcdn.cliente.com%2Faudio.mp3&callback=https%3A%2F%2Fcliente.com%2Fcallback%2Fvoz
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"voice": {
"code": "123456",
"status": "DIAL",
"date": "2026-09-21 11:30:00"
}
}
Observações O parâmetro `callback` é opcional. Para receber os eventos da chamada, informe uma URL HTTPS válida.
Retorna os saldos disponibilizados para a conta neste endpoint.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
saldo
Exemplo de requisição Copiar
https://mex10.com/api/voicecallback.aspx?token=SEU_TOKEN_MEX10&t=saldo
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"balances": {
"sms": 15000,
"email": 2500,
"whatsapp": 0
}
}
Consulta o status de uma chamada de voz pelo `code` retornado no envio.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
status
code
Condicional
Identificador retornado no envio e usado para consulta.
123456
Exemplo de requisição Copiar
https://mex10.com/api/voicecallback.aspx?token=SEU_TOKEN_MEX10&t=status&code=123456
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"status": {
"code": "123456",
"status": "ANSWERED",
"duration": "32",
"date": "2026-09-21 11:30:00"
}
}
Observações Quando ainda não existe status final, a chamada pode retornar `DIAL`. A resposta inclui a duração da chamada em `duration`.
Disponibiliza um arquivo MP3 para uso nas chamadas de voz com callback.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
upload
file
Condicional
Primeiro arquivo multipart/form-data. Somente `.mp3` é aceito.
audio.mp3
filebase64
Condicional
Arquivo MP3 em Base64. Aceita Base64 puro ou data URI.
SUQzBAAAAA...
filename
Condicional
Nome do arquivo no modo Base64 ou URL HTTP/HTTPS para o modo de download remoto.
audio.mp3
Exemplo cURL Copiar
# Multipart
curl -X POST "https://mex10.com/api/voicecallback.aspx" \
-F "token=SEU_TOKEN_MEX10" -F "t=upload" -F "file=@audio.mp3"
# Base64
curl -X POST "https://mex10.com/api/voicecallback.aspx" \
-H "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode "token=SEU_TOKEN_MEX10" --data-urlencode "t=upload" \
--data-urlencode "filename=audio.mp3" \
--data-urlencode "filebase64=SUQzBAAAAA..."
# URL remota
curl -X POST "https://mex10.com/api/voicecallback.aspx" \
-H "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode "token=SEU_TOKEN_MEX10" --data-urlencode "t=upload" \
--data-urlencode "filename=https://cdn.cliente.com/audio.mp3"
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"upload": {
"filename": "4c0a8f..._3f42a1b2c3d4e5f.mp3",
"url": "https://mex10.com/deadpool/dados/4c0a8f..._3f42a1b2c3d4e5f.mp3"
}
}
Observações Somente arquivos `.mp3` são aceitos. O áudio pode ser enviado por multipart/form-data, Base64 ou por URL HTTP/HTTPS.
Voz / Smartico
Voice Smartico
Integração de chamadas de voz destinada ao Smartico.
https://mex10.com/api/voicesmartico.aspx
Autenticação Token MEX10 + IP autorizado
Método principal GET por query string
Resposta JSON
Endpoint https://mex10.com/api/voicesmartico.aspx
Operações disponíveis
Inicia uma chamada de voz pela integração Smartico utilizando uma URL pública de arquivo MP3.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
send
n
Condicional
Número do destinatário. Exemplo brasileiro com DDD.
11981327755
audio
Condicional
URL pública do arquivo MP3 usado na chamada de voz.
https://cdn.cliente.com/audio.mp3
Exemplo de requisição Copiar
https://mex10.com/api/voicesmartico.aspx?token=SEU_TOKEN_MEX10&t=send&n=11981327755&audio=https%3A%2F%2Fcdn.cliente.com%2Faudio.mp3
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"sms": {
"code": "123456",
"status": "DIAL",
"date": "2026-09-21 11:30:00"
}
}
Observações O `code` retornado identifica a chamada. A resposta de sucesso utiliza a chave `sms` por compatibilidade com a integração.
Retorna os saldos disponibilizados para a conta neste endpoint.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
saldo
Exemplo de requisição Copiar
https://mex10.com/api/voicesmartico.aspx?token=SEU_TOKEN_MEX10&t=saldo
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"balances": {
"sms": 15000,
"email": 2500,
"whatsapp": 0
}
}
Consulta o status de uma chamada de voz Smartico pelo `code` retornado no envio.
Parâmetros
Parâmetro Obrigatório Descrição Exemplo
token
Sim
Token de autenticação fornecido pela MEX10.
SEU_TOKEN_MEX10
t
Sim
Operação a executar.
status
code
Condicional
Identificador retornado no envio e usado para consulta.
123456
Exemplo de requisição Copiar
https://mex10.com/api/voicesmartico.aspx?token=SEU_TOKEN_MEX10&t=status&code=123456
Exemplo de resposta Copiar
{
"data": {
"success": true,
"date": "2026-09-21 11:30:00"
},
"errors": {
"error": false,
"description": ""
},
"status": {
"code": "123456",
"status": "ANSWERED",
"duration": "32",
"date": "2026-09-21 11:30:00"
}
}
Observações Quando ainda não existe status final, a chamada pode retornar `DIAL`. A resposta inclui a duração da chamada em `duration`.