API Hotmobile v1.0 · Atualizada em 27/08/2026

Integre SMS, WhatsApp, WhatsApp Cloud e e-mail com menos tentativa e erro.

Documentação prática para autenticar, enviar mensagens, consultar saldos, acompanhar status e trabalhar com templates oficiais da Meta.

Resumo da API

Base pública de produção

Rotas
39
Operações
40
Autenticação
Basic Auth
Formato
JSON
Base URL
https://api.hotmobile.com.br

Quickstart

Primeira requisição em poucos minutos

A API usa Basic Auth. Junte login:senha, converta para Base64 e envie no header Authorization em todas as chamadas HTTPS.

  1. 1Pegue login e senha do painel Hotmobile.
  2. 2Converta login:senha para Base64.
  3. 3Envie Authorization: Basic SEU_TOKEN.
  4. 4Teste uma consulta de saldo antes do primeiro envio.
Enviar SMS com curl
curl --request POST "https://api.hotmobile.com.br/Sms/EnviarMensagem" \
  --header "Authorization: Basic BASE64_DO_SEU_LOGIN_E_SENHA" \
  --header "Content-Type: application/json" \
  --data '{
    "mensagem": "Seu código de confirmação é 123456.",
    "centroDeCusto": "CRM",
    "idExterno": "pedido-9876",
    "listNumeros": [
      { "numero": "11999999999" }
    ]
  }'

Exemplos

Autenticação nos stacks mais comuns

JavaScript
const credentials = btoa("usuario@email.com:senha123");

const response = await fetch("https://api.hotmobile.com.br/Sms/ConsultaSaldo", {
  headers: {
    Authorization: `Basic ${credentials}`,
  },
});

const saldo = await response.json();
PHP
<?php
$credentials = base64_encode("usuario@email.com:senha123");

$ch = curl_init("https://api.hotmobile.com.br/Sms/ConsultaSaldo");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Basic {$credentials}",
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$saldo = json_decode(curl_exec($ch), true);
C#
using var client = new HttpClient();

var token = Convert.ToBase64String(
  Encoding.UTF8.GetBytes("usuario@email.com:senha123")
);

client.DefaultRequestHeaders.Authorization =
  new AuthenticationHeaderValue("Basic", token);

var saldo = await client.GetFromJsonAsync<object>(
  "https://api.hotmobile.com.br/Sms/ConsultaSaldo"
);

Produtos

Escolha o caminho da integração

Ver referência completa

SMS

8 rotas

Envio imediato, agendamento, mensagens personalizadas, status e respostas.

POST /Sms/EnviarMensagem
POST /Sms/ConsultarResposta
GET /Sms/ConsultaSaldo

WhatsApp

17 rotas

Disparos, instâncias, QR Code, grupos, respostas e controle de bot.

POST /WhatsApp/EnviarMensagem
POST /WhatsApp/QrCode
POST /WhatsApp/LigarBot

WhatsApp Cloud

8 rotas

Conexão Meta, sincronização de números, templates oficiais e envio por template.

POST /WhatsAppCloud/Meta/Connect/Start
GET /WhatsAppCloud/Templates
POST /WhatsAppCloud/EnviarTemplate

E-mail

3 rotas

Consulta de saldo, envio de campanhas HTML e acompanhamento por campanha.

POST /Email/EnviarEmail
POST /Email/ConsultarCampanha
GET /Email/ConsultaSaldo

Fluxos

Rotas agrupadas por tarefa

Enviar uma mensagem

  • 1Confira o saldo
  • 2Monte o payload
  • 3Envie a requisição
  • 4Guarde mensagemId ou idExterno

Acompanhar retorno

  • 1Consulte por mensagemId
  • 2Leia statusEnvio
  • 3Busque respostas por data
  • 4Concilie no seu sistema

Usar WhatsApp Cloud

  • 1Conecte a Meta
  • 2Sincronize números
  • 3Sincronize templates
  • 4Envie template aprovado

Retornos

Campos que aparecem com frequência

A maioria das respostas segue um padrão simples: um indicador de erro, uma mensagem textual e identificadores para consulta posterior.

CampoUso
erroIndica se a operação retornou falha lógica.
mensagemRetornoMensagem textual para exibição ou diagnóstico.
mensagemIdIdentificador do envio para consultas futuras.
idExternoIdentificador enviado pelo seu sistema para conciliação.
statusEnvioIdStatus numérico do envio retornado pela plataforma.

Changelog

Última atualização

A referência local foi sincronizada com o OpenAPI público da Hotmobile em 27/08/2026.

+7

Novas rotas WhatsApp Cloud adicionadas.

98

Schemas disponíveis para consulta no Scalar.

JSON

OpenAPI disponível em /openapi.json.