Ler histórico SMS
Retorna {messages: [...]} com id, direction, from, to, text, status e receivedAt. didId/did opcionais devem corresponder; direction é inbound/outbound; limit 1–200, padrão 50. Sem page/cursor. Apenas mensagens na janela confirmada de acesso SMS atual, nunca histórico do antigo cliente. Móvel não significa SMS liberado automaticamente; confira sms.enabled/canSend. Fixos não suportam SMS. Lista vazia pode significar ausência de mensagens elegíveis.
Histórico e envio de SMS para números com SMS liberado.
Base: https://novodid.com. Consulte autenticação e limites antes de executar operações.
Ler histórico SMS
GET /api/v1/sms/messagesRetorna {messages: [...]} com id, direction, from, to, text, status e receivedAt. didId/did opcionais devem corresponder; direction é inbound/outbound; limit 1–200, padrão 50. Sem page/cursor. Apenas mensagens na janela confirmada de acesso SMS atual, nunca histórico do antigo cliente. Móvel não significa SMS liberado automaticamente; confira sms.enabled/canSend. Fixos não suportam SMS. Lista vazia pode significar ausência de mensagens elegíveis.
Permissão: sms:read
- didId: ID numérico do DID próprio
- did: Telefone próprio; deve corresponder ao didId
- direction: inbound (recebido) ou outbound (enviado)
- limit: 1–200 registros, padrão 50
Filtros e parâmetros
?didId=1234&did=5511999999999&direction=inbound&limit=50Resposta de sucesso (200)
{
"messages": [
{
"id": "example-message",
"direction": "inbound",
"from": "5511988888888",
"to": "5511999999999",
"text": "Example message",
"status": "received",
"receivedAt": "2026-09-23T13:00:00.000Z"
}
]
}Exemplo de erro
{
"error": {
"code": "insufficient_scope",
"message": "Token sem permissão para esta operação."
}
}curl
curl -X GET \
-H "Authorization: Bearer $NOVODID_API_TOKEN" \
"https://novodid.com/api/v1/sms/messages?didId=1234&did=5511999999999&direction=inbound&limit=50"Node
const response = await fetch("https://novodid.com/api/v1/sms/messages?didId=1234&did=5511999999999&direction=inbound&limit=50", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.NOVODID_API_TOKEN}`
}
});
const payload = await response.json();
if (!response.ok) {
throw new Error(payload.error?.message || "Erro na API NovoDID");
}
console.log({ status: response.status });Python
import os
import requests
response = requests.get(
"https://novodid.com/api/v1/sms/messages?didId=1234&did=5511999999999&direction=inbound&limit=50",
headers={"Authorization": f"Bearer {os.environ['NOVODID_API_TOKEN']}"},
timeout=30,
)
payload = response.json()
response.raise_for_status()
print({"status": response.status_code})Go
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("GET", "https://novodid.com/api/v1/sms/messages?didId=1234&did=5511999999999&direction=inbound&limit=50", nil)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("NOVODID_API_TOKEN"))
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
_, _ = io.Copy(io.Discard, res.Body)
if res.StatusCode >= 300 {
panic(fmt.Sprintf("NovoDID API HTTP %d", res.StatusCode))
}
fmt.Println(res.StatusCode)
}Rust
use reqwest::blocking::Client;
use std::env;
fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.get("https://novodid.com/api/v1/sms/messages?didId=1234&did=5511999999999&direction=inbound&limit=50")
.bearer_auth(env::var("NOVODID_API_TOKEN")?)
.send()?;
let status = response.status();
let _payload = response.text()?;
if !status.is_success() {
return Err(format!("NovoDID API HTTP {}", status).into());
}
println!("HTTP {}", status);
Ok(())
}PHP
<?php
$ch = curl_init("https://novodid.com/api/v1/sms/messages?didId=1234&did=5511999999999&direction=inbound&limit=50");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("NOVODID_API_TOKEN")
],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($response === false || $status >= 300) {
throw new RuntimeException("NovoDID API HTTP " . $status);
}
echo $status . PHP_EOL;Ruby
require "net/http"
uri = URI("https://novodid.com/api/v1/sms/messages?didId=1234&did=5511999999999&direction=inbound&limit=50")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("NOVODID_API_TOKEN")}"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
http.request(request)
end
raise "NovoDID API HTTP #{response.code}" unless response.is_a?(Net::HTTPSuccess)
puts response.codeC#
using System.Net.Http.Headers;
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://novodid.com/api/v1/sms/messages?didId=1234&did=5511999999999&direction=inbound&limit=50");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Bearer",
Environment.GetEnvironmentVariable("NOVODID_API_TOKEN")
);
using var response = await client.SendAsync(request);
var payload = await response.Content.ReadAsStringAsync();
response.EnsureSuccessStatusCode();
Console.WriteLine(response.StatusCode);SMS
Histórico e envio de SMS para números com SMS liberado.
Enviar ou responder SMS
Obrigatórios: from=seu DID autorizado com SMS, to=destinatário, text=mensagem (após trim, 1–1600 caracteres). Telefones: 10–15 dígitos, + inicial opcional. didId opcional deve corresponder a from. O envio só responde a um SMS de entrada desse destino para o DID, recebido desde o início do acesso SMS da posse atual. Mensagem enviada antes, outro contato, posse anterior ou falha ao consultar o histórico não autorizam o envio. Não há liberação de conta para iniciar conversa. 201 confirma submissão, não entrega ao aparelho. message contém id, smscMessageId (podem ser null), didId, from, to, textLength e newConversation, que é false. Sem chave de idempotência: após timeout, confira histórico antes de repetir.