SMSMobileAPI – Documentação da API de Gerenciamento de Chamadas

Documentação da API de Gerenciamento de Chamadas

Esses endpoints permitem que você recupere seu Chamadas Perdidas, Chamadas recebidas atendidas, e Chamadas efetuadas Sincronizado do aplicativo móvel SMSMobileAPI para seu painel de controle + API.

Importante: se o aplicativo móvel estiver em execução em segundo plano, o sistema do telefone poderá impor um atraso (geralmente de até 10 minutos) entre as sincronizações. Você sempre pode abrir o aplicativo para sincronizar manualmente, se necessário.

Apoiar: api@smsmobileapi.com

Procurar

Início rápido

URL base

PEGARhttps://api.smsmobileapi.com

Todos os endpoints abaixo estão documentados como PEGAR solicitações. Substituir SUA_CHAVE_API Com sua chave verdadeira (não a compartilhe publicamente).

Exemplos


GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY


GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc


GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=3247&date_from_ms=1700000000000&date_to_ms=1700864000000

Autenticação

Os endpoints de gerenciamento de chamadas autenticam-se usando o apikey parâmetro de consulta.

Validação da assinatura: Os endpoints de entrada/saída validam sua chave de API e verificam a validade da sua assinatura (com base em dateLimit >= CURDATE()Se expirado, você receberá api_expiradoO endpoint de chamadas perdidas pode retornar um erro genérico de "Chave de API ausente" ou erros do servidor, dependendo das condições.

Conceitos comuns

Paginação

Usar limite e desvio Para paginar os resultados.

Carimbos de data/hora

data_da_chamada_ms é um timestamp UNIX em milissegundos.
call_datetime_utc é armazenado como uma string de data e hora UTC (campo do banco de dados).
Para chamadas perdidas, a API retorna um valor formatado. data string (derivada de um valor em milissegundos).

Procurar

Chamadas perdidas: procurar Corresponde ao número ou nome.
Entrada/Saída: q Corresponde a número de telefone ou nome armazenado em cache.

Triagem (somente entrada/saída)

A classificação é controlada por ordenar por + diretório_de_ordenar (Apenas campos permitidos). As chamadas perdidas são sempre ordenadas da mais recente para a mais antiga.

Erros

HTTP	Exemplo de erro	Significado
400	`{"success":false,"error":"missing_apikey"}`	Ausente ou vazio `apikey`.
403	`{"success":false,"error":"invalid_apikey"}`	Chave de API não encontrada/não reconhecida.
403	`{"success":false,"error":"api_expired"}`	Sua assinatura expirou (`limite de data` é anterior a hoje).
500	`{"success":false,"error":"server_error","detail":"..."}`	Erro do servidor (banco de dados, SQL, exceção).

Observação: o endpoint de Chamadas Perdidas também pode retornar mensagens como Chave de API ausente ou erros de preparação de SQL, dependendo da situação.

Lista de chamadas perdidas

Recuperar chamadas perdidas sincronizadas do dispositivo móvel.

Ponto final

PEGARhttps://api.smsmobileapi.com/call/missed/list/

Parâmetros de consulta

Parâmetro	Tipo	Descrição
Obrigatório`apikey`	corda	Sua chave de API está vinculada ao celular.
Opcional`desvio`	inteiro	Deslocamento de paginação (padrão: `0`).
Opcional`limite`	inteiro	Número máximo de linhas a serem retornadas (padrão: `100`, máximo: `500`).
Opcional`procurar`	corda	Pesquisa por número ou nome (SQL LIKE).
Opcional`data_início`	AAAA-MM-DD	Filtrar a partir deste dia (00:00:00). Comparar com o registro de data e hora em milissegundos armazenado.
Opcional`data_fim`	AAAA-MM-DD	Filtrar até este dia (23:59:59). Comparar com o registro de data e hora em milissegundos armazenado.

Classificação

Corrigido: mais recente primeiro (ORDENAR POR data DESC).

Exemplo de solicitação


GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&limit=100&offset=0&search=John&date_start=2026-02-01&date_end=2026-02-24

Exemplo de resposta

{ "success": true, "offset": 0, "limit": 100, "count": 2, "data": [ { "number": "+123470000000", "name": "John Doe", "date": "2026-02-24 12:49:39" }, { "number": "+123471111111", "name": "", "date": "2026-02-24 11:12:09" } ] }

Lista de chamadas recebidas

Recuperar chamadas recebidas e atendidas, sincronizadas a partir do dispositivo móvel.

Ponto final

PEGARhttps://api.smsmobileapi.com/call/incoming/list/

Parâmetros de consulta

Parâmetro	Tipo	Descrição
Obrigatório`apikey`	corda	Sua chave de API. Validada em relação à assinatura (`limite de data`).
Opcional`limite`	inteiro	Linhas por página (padrão: `50`, mínimo 1, máximo `200`).
Opcional`desvio`	inteiro	Deslocamento de paginação (padrão: `0`).
Opcional`ordenar por`	corda	Campo de classificação (padrão: `data_da_chamada_ms`). Permitido: `data_da_chamada_ms`, `call_datetime_utc`, `duração_segundos`, `número_de_telefone`, `criado_em`, `nome_em_cache`, `geolocalização`.
Opcional`diretório_de_ordenar`	asc\|desc	Direção de classificação (padrão: `descrição`).
Opcional`data_de_ms`	int (ms)	Filtrar onde `data_de_chamada_ms >= data_de_origem_ms`.
Opcional`data_para_ms`	int (ms)	Filtrar onde `data_da_chamada_ms <= data_para_ms`.
Opcional`q`	corda	Pesquisar (CURTIR) em `número_de_telefone` ou `nome_em_cache`.

Exemplo de solicitação


GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=100&offset=0&sort_by=call_date_ms&sort_dir=desc&q=3247

Exemplo de resposta

{ "success": true, "apikey": "YOUR_API_KEY", "limit": 100, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": "+12347" }, "count": 2, "rows": [ { "phone_number": "+123470000000", "cached_name": "Matteo Css", "call_date_ms": 1761233379000, "call_datetime_utc": "2026-02-23 12:49:39", "duration_sec": 440, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:38" } ] }

Lista de chamadas efetuadas

Recuperar chamadas efetuadas e sincronizadas do dispositivo móvel.

Ponto final

PEGARhttps://api.smsmobileapi.com/call/outgoing/list/

Parâmetros de consulta

Os parâmetros e o comportamento são os mesmos das chamadas recebidas.

Parâmetro	Tipo	Descrição
Obrigatório`apikey`	corda	Sua chave de API. Validada em relação à assinatura (`limite de data`).
Opcional`limite`	inteiro	Linhas por página (padrão: `50`, máximo `200`).
Opcional`desvio`	inteiro	Deslocamento de paginação (padrão: `0`).
Opcional`ordenar por`	corda	Padrão `data_da_chamada_ms`. Permitido: `data_da_chamada_ms`, `call_datetime_utc`, `duração_segundos`, `número_de_telefone`, `criado_em`, `nome_em_cache`, `geolocalização`.
Opcional`diretório_de_ordenar`	asc\|desc	Padrão `descrição`.
Opcional`data_de_ms`	int (ms)	Filtrar a partir deste carimbo de data/hora (ms).
Opcional`data_para_ms`	int (ms)	Filtrar até este carimbo de data/hora (ms).
Opcional`q`	corda	Pesquisar em `número_de_telefone` ou `nome_em_cache`.

Exemplo de solicitação


GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=duration_sec&sort_dir=desc&date_from_ms=1700000000000&date_to_ms=1700864000000

Exemplo de resposta

{ "success": true, "apikey": "YOUR_API_KEY", "limit": 50, "offset": 0, "sort_by": "duration_sec", "sort_dir": "desc", "filters": { "date_from_ms": "1700000000000", "date_to_ms": "1700864000000", "q": null }, "count": 1, "rows": [ { "phone_number": "+123490000000", "cached_name": null, "call_date_ms": 1761231000000, "call_datetime_utc": "2026-02-23 12:10:00", "duration_sec": 120, "geo_location": "Bélgica", "created_at": "2026-02-24 04:14:37" } ] }

campos de chamadas perdidas

Campo	Tipo	Descrição
`sucesso`	booleano	Status da solicitação.
`desvio`	inteiro	Deslocamento de paginação retornado.
`limite`	inteiro	Limite de paginação retornado.
`contar`	inteiro	Número de linhas retornadas em `dados`.
`dados`	variedade	Lista de chamadas perdidas.
`dados[].número`	corda	Número de telefone do chamador.
`data[].name`	corda	Nome do contato em cache (pode estar vazio).
`data[].data`	corda	Cadeia de data e hora formatada derivada de um registro de data e hora em milissegundos.

Campos de entrada/saída

Campo	Tipo	Descrição
`sucesso`	booleano	Status da solicitação.
`apikey`	corda	Resposta enviada pela API (sua chave).
`limite`	inteiro	Número de linhas retornadas por página.
`desvio`	inteiro	Deslocamento de paginação retornado.
`ordenar por`	corda	Campo de classificação aplicado.
`diretório_de_ordenar`	corda	Direção de classificação aplicada.
`filtros`	objeto	Filtros com eco (`data_de_ms`, `data_para_ms`, `q`).
`contar`	inteiro	Número de linhas retornadas em `linhas`.
`linhas`	variedade	Lista de chamadas.
`linhas[].número_de_telefone`	corda	Número de telefone.
`linhas[].nome_em_cache`	string\|nulo	Nome do contato em cache (pode ser nulo).
`linhas[].call_date_ms`	inteiro	Registro de data e hora da chamada em milissegundos.
`linhas[].call_datetime_utc`	corda	Campo de data e hora UTC (banco de dados).
`linhas[].duração_seg`	inteiro	Duração em segundos.
`linhas[].geo_localização`	string\|nulo	Rótulo de geolocalização (pode ser nulo/vazio).
`linhas[].criadas_em`	corda	Carimbo de data/hora de inserção do servidor.

Documentação de API e desenvolvedor

Ferramentas e log de alterações

Documentação da API de Gerenciamento de Chamadas

Início rápido

URL base

Exemplos

Autenticação

Conceitos comuns

Paginação

Carimbos de data/hora

Procurar

Triagem (somente entrada/saída)

Erros

Lista de chamadas perdidas

Ponto final

Parâmetros de consulta

Classificação

Exemplo de solicitação

Exemplo de resposta

Lista de chamadas recebidas

Ponto final

Parâmetros de consulta

Exemplo de solicitação

Exemplo de resposta

Lista de chamadas efetuadas

Ponto final

Parâmetros de consulta

Exemplo de solicitação

Exemplo de resposta

campos de chamadas perdidas

Campos de entrada/saída

💬 Chat ao vivo disponível