API REST de SMS IAGENTEsms — envio via JSON com Bearer token

<?php
$ctx = stream_context_create(['http' => [
    'header' => "Authorization: Bearer sk_live_..."
]]);

$response = file_get_contents('https://api.iagentesms.com.br/api/v2/credits', false, $ctx);
$data = json_decode($response, true);
echo "Saldo: {$data['data']['available']}";
?>

import requests

resp = requests.get(
    "https://api.iagentesms.com.br/api/v2/credits",
    headers={"Authorization": "Bearer sk_live_..."},
)
print("Saldo:", resp.json()["data"]["available"])

const resp = await fetch("https://api.iagentesms.com.br/api/v2/credits", {
  headers: { "Authorization": "Bearer sk_live_..." },
});
const { data } = await resp.json();
console.log("Saldo:", data.available);

<?php
$ch = curl_init('https://api.iagentesms.com.br/api/v2/messages');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer sk_live_...',
        'Content-Type: application/json',
        'Idempotency-Key: pedido-42',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'to'         => '5551999998888',
        'message'    => 'Olá! Seu código é 1234.',
        'client_ref' => 'abc',
    ]),
]);

$response = curl_exec($ch);
$status   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$body = json_decode($response, true);
echo $status === 201 ? "Enviado: {$body['data']['id']}" : "Erro: {$body['error']['code']}";
?>

import requests

resp = requests.post(
    "https://api.iagentesms.com.br/api/v2/messages",
    headers={
        "Authorization": "Bearer sk_live_...",
        "Idempotency-Key": "pedido-42",
    },
    json={
        "to": "5551999998888",
        "message": "Olá! Seu código é 1234.",
        "client_ref": "abc",
    },
)

data = resp.json()
if resp.status_code == 201:
    print("Enviado:", data["data"]["id"])
else:
    print("Erro:", data["error"]["code"])

const resp = await fetch("https://api.iagentesms.com.br/api/v2/messages", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_...",
    "Content-Type": "application/json",
    "Idempotency-Key": "pedido-42",
  },
  body: JSON.stringify({
    to: "5551999998888",
    message: "Olá! Seu código é 1234.",
    client_ref: "abc",
  }),
});

const data = await resp.json();
if (resp.status === 201) {
  console.log("Enviado:", data.data.id);
} else {
  console.error("Erro:", data.error.code);
}

<?php
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer sk_live_...\r\nContent-Type: application/json",
    'content' => json_encode([
        'to'      => ['5551999998888', '5551988887777'],
        'message' => 'Promoção especial só hoje!',
    ]),
]]);

echo file_get_contents('https://api.iagentesms.com.br/api/v2/messages/batch', false, $ctx);
?>

import requests

resp = requests.post(
    "https://api.iagentesms.com.br/api/v2/messages/batch",
    headers={"Authorization": "Bearer sk_live_..."},
    json={
        "to": ["5551999998888", "5551988887777"],
        "message": "Promoção especial só hoje!",
    },
)
print(resp.json())

const resp = await fetch("https://api.iagentesms.com.br/api/v2/messages/batch", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: ["5551999998888", "5551988887777"],
    message: "Promoção especial só hoje!",
  }),
});
console.log(await resp.json());

<?php
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer sk_live_...\r\nContent-Type: application/json",
    'content' => json_encode(['message' => 'Mensagem para todo o grupo!']),
]]);

echo file_get_contents('https://api.iagentesms.com.br/api/v2/groups/42/messages', false, $ctx);
?>

import requests

resp = requests.post(
    "https://api.iagentesms.com.br/api/v2/groups/42/messages",
    headers={"Authorization": "Bearer sk_live_..."},
    json={"message": "Mensagem para todo o grupo!"},
)
print(resp.json())

const resp = await fetch("https://api.iagentesms.com.br/api/v2/groups/42/messages", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ message: "Mensagem para todo o grupo!" }),
});
console.log(await resp.json());

<?php
$ctx = stream_context_create(['http' => [
    'header' => "Authorization: Bearer sk_live_...",
]]);

// Status de um envio
$response = file_get_contents('https://api.iagentesms.com.br/api/v2/messages/123', false, $ctx);
$data = json_decode($response, true);
echo "Status: {$data['data']['status']}";
?>

import requests

# Status de um envio
resp = requests.get(
    "https://api.iagentesms.com.br/api/v2/messages/123",
    headers={"Authorization": "Bearer sk_live_..."},
)
print("Status:", resp.json()["data"]["status"])

// Status de um envio
const resp = await fetch("https://api.iagentesms.com.br/api/v2/messages/123", {
  headers: { "Authorization": "Bearer sk_live_..." },
});
const { data } = await resp.json();
console.log("Status:", data.status);

<?php
$base  = 'https://api.iagentesms.com.br/api/v2';
$token = 'sk_live_...';

function api($method, $url, $token, $body = null) {
    $opts = ['http' => [
        'method' => $method,
        'header' => "Authorization: Bearer $token\r\nContent-Type: application/json",
        'ignore_errors' => true,
    ]];
    if ($body !== null) $opts['http']['content'] = json_encode($body);
    return json_decode(file_get_contents($url, false, stream_context_create($opts)), true);
}

// Criar grupo
$grupo = api('POST', "$base/groups", $token, ['nome' => 'Clientes VIP']);

// Adicionar contato ao grupo 42
api('POST', "$base/groups/42/contacts", $token, [
    'nome' => 'João Silva', 'celular' => '5551999998888',
]);

// Listar contatos
$contatos = api('GET', "$base/groups/42/contacts", $token);

// Esvaziar o grupo
api('POST', "$base/groups/42/clear", $token);
?>

import requests

base = "https://api.iagentesms.com.br/api/v2"
headers = {"Authorization": "Bearer sk_live_..."}

# Criar grupo
grupo = requests.post(f"{base}/groups", headers=headers,
                      json={"nome": "Clientes VIP"}).json()

# Adicionar contato ao grupo 42
requests.post(f"{base}/groups/42/contacts", headers=headers,
              json={"nome": "João Silva", "celular": "5551999998888"})

# Listar contatos
contatos = requests.get(f"{base}/groups/42/contacts", headers=headers).json()

# Esvaziar o grupo
requests.post(f"{base}/groups/42/clear", headers=headers)

const base = "https://api.iagentesms.com.br/api/v2";
const headers = {
  "Authorization": "Bearer sk_live_...",
  "Content-Type": "application/json",
};

// Criar grupo
const grupo = await (await fetch(`${base}/groups`, {
  method: "POST", headers, body: JSON.stringify({ nome: "Clientes VIP" }),
})).json();

// Adicionar contato ao grupo 42
await fetch(`${base}/groups/42/contacts`, {
  method: "POST", headers,
  body: JSON.stringify({ nome: "João Silva", celular: "5551999998888" }),
});

// Listar contatos
const contatos = await (await fetch(`${base}/groups/42/contacts`, { headers })).json();

// Esvaziar o grupo
await fetch(`${base}/groups/42/clear`, { method: "POST", headers });

<?php
$ctx = stream_context_create(['http' => [
    'header' => "Authorization: Bearer sk_live_..."
]]);

echo file_get_contents('https://api.iagentesms.com.br/api/v2/inbound', false, $ctx);
?>

import requests

resp = requests.get(
    "https://api.iagentesms.com.br/api/v2/inbound",
    headers={"Authorization": "Bearer sk_live_..."},
)
print(resp.json())

const resp = await fetch("https://api.iagentesms.com.br/api/v2/inbound", {
  headers: { "Authorization": "Bearer sk_live_..." },
});
console.log(await resp.json());

<?php
$ctx = stream_context_create(['http' => [
    'method'  => 'POST',
    'header'  => "Authorization: Bearer sk_live_...\r\nContent-Type: application/json",
    'content' => json_encode([
        'numbers' => ['5551999998888', '5551988887777'],
    ]),
]]);

echo file_get_contents('https://api.iagentesms.com.br/api/v2/numbers/validate', false, $ctx);
?>

import requests

resp = requests.post(
    "https://api.iagentesms.com.br/api/v2/numbers/validate",
    headers={"Authorization": "Bearer sk_live_..."},
    json={"numbers": ["5551999998888", "5551988887777"]},
)
print(resp.json())

const resp = await fetch("https://api.iagentesms.com.br/api/v2/numbers/validate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer sk_live_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ numbers: ["5551999998888", "5551988887777"] }),
});
console.log(await resp.json());