MEX10 · Integrações

Documentação da API

Referência de integração das APIs SMS, RCS e Voice da MEX10.

Base URL: https://mex10.com/api/GETJSONToken + IP

Autenticação e convenções

As APIs utilizam um token fornecido pela MEX10 e validação do IP de origem autorizado para a conta.

Padrão de integração: utilize GET por query string para envios e consultas. O upload de áudio utiliza POST conforme os exemplos específicos.

A maioria das respostas utiliza os objetos data e errors.

APIs disponíveis

API	Endpoint	Operações
SMS	`/api/shortcodeV2.aspx`	Enviar SMS · Saldo · Status · Status detalhado · Respostas · Fila · Blacklist
RCS	`/api/rcs.aspx`	Enviar RCS · Saldo · Status
Voice	`/api/voice.aspx`	Enviar chamada · Saldo · Status · Upload de MP3
Voice + Callback	`/api/voicecallback.aspx`	Enviar chamada · Saldo · Status · Upload de MP3
Voice Smartico	`/api/voicesmartico.aspx`	Enviar chamada · Saldo · Status
RCS Smartico	`/api/smarticorcssms.aspx`	Enviar RCS Smartico
Recarga	`/api/recargav1.aspx`	Gerar QR Code PIX para compra de créditos SMS, VOZ, RCS e WPP

Erros da API

TOKEN_INVALID · CODE_INVALID · PARAMETER_TYPE_INVALID · API_DESABILITADA(FALE COM NOSSO SUPORTE) · SEM_SALDO · CODE_NOT_FOUND · BLOCKED · BLOCKED_IP_EMPTY · IP_BLOCKED · ERRO_AUTH

A disponibilidade de cada erro depende da operação utilizada.

SMS

Envio e consulta de mensagens SMS.

https://mex10.com/api/shortcodeV2.aspx

AutenticaçãoToken MEX10 + IP autorizado

Método principalGET por query string

RespostaJSON

Endpointhttps://mex10.com/api/shortcodeV2.aspx

Operações disponíveis

GET · t=send

Enviar SMS

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

https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=send&n=11981327755&m=Mensagem%20de%20teste

Exemplo de resposta

{
  "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.

GET · t=saldo

Consultar saldo

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

https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=saldo

Exemplo de resposta

{
  "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`.

GET · t=status

Consultar status

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

https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=status&code=5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0

Exemplo de resposta

{
  "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`.

GET · t=status2

Consultar status detalhado

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

https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=status2&code=5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0

Exemplo de resposta

{
  "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`.

GET · t=response

Consultar respostas recebidas

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

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

{
  "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.

GET · t=queue

Consultar fila SMS

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

https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=queue

Exemplo de resposta

{
  "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.

GET · t=cancelqueue

Cancelar fila SMS

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

https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=cancelqueue

Exemplo de resposta

{
  "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.

GET · t=blacklist

Consultar blacklist SMS

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

https://mex10.com/api/shortcodeV2.aspx?token=SEU_TOKEN_MEX10&t=blacklist

Exemplo de resposta

{
  "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

Envio de mensagens RCS com Rich Card, imagem e ação por link.

https://mex10.com/api/rcs.aspx

AutenticaçãoToken MEX10 + IP autorizado

Método principalGET por query string

RespostaJSON

Endpointhttps://mex10.com/api/rcs.aspx

Operações disponíveis

GET · t=send

Enviar RCS

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

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

{
  "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.

GET · t=saldo

Consultar saldo

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

https://mex10.com/api/rcs.aspx?token=SEU_TOKEN_MEX10&t=saldo

Exemplo de resposta

{
  "data": {
    "success": true,
    "date": "2026-09-21 11:30:00"
  },
  "errors": {
    "error": false,
    "description": ""
  },
  "balances": {
    "sms": 15000,
    "email": 2500,
    "whatsapp": 0
  }
}

GET · t=status

Consultar status RCS

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

https://mex10.com/api/rcs.aspx?token=SEU_TOKEN_MEX10&t=status&code=5f48a0f0-37e8-4f43-9d26-2f120ba3dfb0

Exemplo de resposta

{
  "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çãoToken MEX10 + IP autorizado

Método principalGET para chamadas e consultas · POST para upload

RespostaJSON

Endpointhttps://mex10.com/api/voice.aspx

Operações disponíveis

GET · t=send

Enviar chamada de voz

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

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

{
  "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.

GET · t=saldo

Consultar saldo

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

https://mex10.com/api/voice.aspx?token=SEU_TOKEN_MEX10&t=saldo

Exemplo de resposta

{
  "data": {
    "success": true,
    "date": "2026-09-21 11:30:00"
  },
  "errors": {
    "error": false,
    "description": ""
  },
  "balances": {
    "sms": 15000,
    "email": 2500,
    "voz": 300
  }
}

GET · t=status

Consultar status da chamada

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

https://mex10.com/api/voice.aspx?token=SEU_TOKEN_MEX10&t=status&code=123456

Exemplo de resposta

{
  "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`.

POST · t=upload

Upload de áudio MP3

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

# 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

{
  "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

Voice + Callback

Chamadas de voz com callback associado à chamada.

https://mex10.com/api/voicecallback.aspx

AutenticaçãoToken MEX10 + IP autorizado

Método principalGET para chamadas e consultas · POST para upload

RespostaJSON

Endpointhttps://mex10.com/api/voicecallback.aspx

Operações disponíveis

GET · t=send

Enviar chamada com callback

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

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

{
  "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.

GET · t=saldo

Consultar saldo

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

https://mex10.com/api/voicecallback.aspx?token=SEU_TOKEN_MEX10&t=saldo

Exemplo de resposta

{
  "data": {
    "success": true,
    "date": "2026-09-21 11:30:00"
  },
  "errors": {
    "error": false,
    "description": ""
  },
  "balances": {
    "sms": 15000,
    "email": 2500,
    "whatsapp": 0
  }
}

GET · t=status

Consultar status da chamada

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

https://mex10.com/api/voicecallback.aspx?token=SEU_TOKEN_MEX10&t=status&code=123456

Exemplo de resposta

{
  "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`.

POST · t=upload

Upload de áudio MP3

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

# 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

{
  "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çãoToken MEX10 + IP autorizado

Método principalGET por query string

RespostaJSON

Endpointhttps://mex10.com/api/voicesmartico.aspx

Operações disponíveis

GET · t=send

Enviar voz Smartico

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

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

{
  "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.

GET · t=saldo

Consultar saldo

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

https://mex10.com/api/voicesmartico.aspx?token=SEU_TOKEN_MEX10&t=saldo

Exemplo de resposta

{
  "data": {
    "success": true,
    "date": "2026-09-21 11:30:00"
  },
  "errors": {
    "error": false,
    "description": ""
  },
  "balances": {
    "sms": 15000,
    "email": 2500,
    "whatsapp": 0
  }
}

GET · t=status

Consultar status da chamada

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

https://mex10.com/api/voicesmartico.aspx?token=SEU_TOKEN_MEX10&t=status&code=123456

Exemplo de resposta

{
  "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`.

RCS / Smartico

RCS Smartico

Integração RCS destinada ao Smartico.

https://mex10.com/api/smarticorcssms.aspx

AutenticaçãoToken MEX10 + IP autorizado

Método principalGET por query string

RespostaJSON

Endpointhttps://mex10.com/api/smarticorcssms.aspx

Operações disponíveis

GET · t=send

Enviar RCS Smartico

Envia uma mensagem RCS pela integração Smartico utilizando um payload JSON no parâmetro `m`.

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	JSON Smartico com `title`, `description`, `fileUrl`, `suggestions_title` e `suggestions_value`.	`{"title":"Oferta do dia","description":"Aproveite nossa oferta especial","fileUrl":"cdn.cliente.com/banner.jpg","suggestions_title":"Ver oferta","suggestions_value":"https://cliente.com/oferta"}`

Exemplo de requisição

https://mex10.com/api/smarticorcssms.aspx?token=SEU_TOKEN_MEX10&t=send&n=11981327755&m=%7B%22title%22%3A%22Oferta%20do%20dia%22%2C%22description%22%3A%22Aproveite%20nossa%20oferta%20especial%22%2C%22fileUrl%22%3A%22cdn.cliente.com%2Fbanner.jpg%22%2C%22suggestions_title%22%3A%22Ver%20oferta%22%2C%22suggestions_value%22%3A%22https%3A%2F%2Fcliente.com%2Foferta%22%7D

Exemplo de resposta

{
  "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

`m` deve conter `title`, `description`, `fileUrl`, `suggestions_title` e `suggestions_value`.
`description` é utilizado como texto principal da mensagem.
`suggestions_title` define o texto do botão e `suggestions_value` define a URL da ação.
Em `fileUrl`, informe host e caminho, por exemplo `cdn.cliente.com/banner.jpg`.
A resposta de sucesso utiliza a chave `sms` por compatibilidade com a integração.

Recarga · PIX

Recarga

Compre créditos de SMS, VOZ, RCS ou WPP de forma rápida e automática, com pagamento via PIX.

https://mex10.com/api/recargav1.aspx

AutenticaçãoToken MEX10 + IP autorizado

Método principalGET por query string

RespostaJSON com PIX copia e cola

Quantidade permitida100 a 1.000.000 créditos

Operações disponíveis

GET · t=pay

Gerar PIX de recarga

Gera um código PIX copia e cola para recarregar os créditos do produto escolhido. Após a confirmação do pagamento, os créditos são adicionados automaticamente à conta do cliente, sem intervenção manual.

Parâmetros

Parâmetro	Obrigatório	Descrição	Exemplo
`token`	Sim	Token de autenticação individual fornecido pela MEX10.	`SEU_TOKEN_MEX10`
`t`	Sim	Operação para gerar o pagamento PIX de recarga. Utilize `pay`.	`pay`
`produto`	Sim	Produto a recarregar. Aceita exclusivamente `SMS`, `VOZ`, `RCS` ou `WPP`, escritos exatamente em maiúsculas.	`SMS`
`qtde`	Sim	Quantidade total de créditos desejada. Deve ser um número inteiro de 100 a 1.000.000, inclusive.	`100`

Exemplo de requisição

https://mex10.com/api/recargav1.aspx?token=SEU_TOKEN_MEX10&t=pay&produto=SMS&qtde=100

Exemplo de resposta

{
  "data": {
    "success": true,
    "date": "2026-10-30 10:23:23"
  },
  "errors": {
    "error": false,
    "description": ""
  },
  "qrcode": "00020101021226800014br.gov.bcb.pix2558pix.asaas.com/qr/cobv/bb7f76f8-ec99-42f4-9c94-8bc76e9b69ff5204000053039865802BR5925DIGITAL SAC DO BRASIL LTD6006Santos61081101554062070503***630451FB"
}

Observações importantes

O token deve pertencer à conta do cliente, e o IP de origem da requisição deve estar previamente cadastrado e autorizado na MEX10.
Valores de qtde inferiores a 100 ou superiores a 1.000.000 não são permitidos.
Informe produto exatamente como SMS, VOZ, RCS ou WPP. Outras grafias não são aceitas.
O campo qrcode contém o código PIX copia e cola gerado para aquela solicitação. Cada nova recarga deve utilizar o código retornado pela sua própria requisição; o código mostrado acima é apenas um exemplo de resposta.
data.success = true indica que a solicitação de geração do PIX foi bem-sucedida, não que ele já foi pago.
Assim que o pagamento PIX for confirmado, os créditos são liberados automaticamente na conta do cliente, de forma imediata, sem necessidade de avisar o suporte.