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
$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
// webhook.php — configure esta URL no painel do IAGENTEsms

$clientRef = $_GET['codigosms'] ?? '';
$celular   = $_GET['celular'] ?? '';
$shortcode = $_GET['shortcode'] ?? '';
$status    = $_GET['status'] ?? '';
$mensagem  = $_GET['mensagem'] ?? '';
$data      = $_GET['data'] ?? '';
$canal     = $_GET['canal'] ?? '';

if ($status === 'Resposta') {
    // Mensagem recebida do destinatário — veja "Respostas via Webhook"
    http_response_code(200);
    exit('OK');
}

$pdo = new PDO('mysql:host=localhost;dbname=seudb', 'usuario', 'senha');
$stmt = $pdo->prepare(
    "INSERT INTO sms_status (client_ref, celular, shortcode, status, data_status, canal)
     VALUES (?, ?, ?, ?, ?, ?)"
);
$stmt->execute([$clientRef, $celular, $shortcode, $status, $data, $canal]);

http_response_code(200);
echo 'OK';
?>

from flask import Flask, request

app = Flask(__name__)

@app.get("/webhook/sms")
def webhook_sms():
    p = request.args

    if p.get("status") == "Resposta":
        # Mensagem recebida do destinatário — veja "Respostas via Webhook"
        return "OK", 200

    salvar_status(
        client_ref=p.get("codigosms"),
        celular=p.get("celular"),
        shortcode=p.get("shortcode"),
        status=p.get("status"),
        data=p.get("data"),
        canal=p.get("canal"),
    )
    return "OK", 200

import express from "express";

const app = express();

app.get("/webhook/sms", async (req, res) => {
  const { codigosms, celular, shortcode, status, data, canal } = req.query;

  if (status === "Resposta") {
    // Mensagem recebida do destinatário — veja "Respostas via Webhook"
    return res.status(200).send("OK");
  }

  await salvarStatus({ clientRef: codigosms, celular, shortcode, status, data, canal });
  res.status(200).send("OK");
});

app.listen(3000);

<?php
// webhook.php — mesma URL do webhook de status

$status = $_GET['status'] ?? '';

if ($status !== 'Resposta') {
    // Mudança de status de entrega — veja "Webhook"
    http_response_code(200);
    exit('OK');
}

$clientRef = $_GET['codigosms'] ?? '';   // vazio quando é keyword
$celular   = $_GET['celular'] ?? '';
$shortcode = $_GET['shortcode'] ?? '';
$mensagem  = $_GET['mensagem'] ?? '';
$data      = $_GET['data'] ?? '';
$canal     = $_GET['canal'] ?? '';

$pdo = new PDO('mysql:host=localhost;dbname=seudb', 'usuario', 'senha');
$stmt = $pdo->prepare(
    "INSERT INTO sms_recebidos (client_ref, celular, shortcode, mensagem, data_recebimento, canal)
     VALUES (?, ?, ?, ?, ?, ?)"
);
$stmt->execute([$clientRef, $celular, $shortcode, $mensagem, $data, $canal]);

http_response_code(200);
echo 'OK';
?>

from flask import Flask, request

app = Flask(__name__)

@app.get("/webhook/sms")
def webhook_sms():
    p = request.args

    if p.get("status") != "Resposta":
        # Mudança de status de entrega — veja "Webhook"
        return "OK", 200

    salvar_recebida(
        client_ref=p.get("codigosms"),   # vazio quando é keyword
        celular=p.get("celular"),
        shortcode=p.get("shortcode"),
        mensagem=p.get("mensagem"),
        data=p.get("data"),
        canal=p.get("canal"),
    )
    return "OK", 200

import express from "express";

const app = express();

app.get("/webhook/sms", async (req, res) => {
  const { codigosms, celular, shortcode, status, mensagem, data, canal } = req.query;

  if (status !== "Resposta") {
    // Mudança de status de entrega — veja "Webhook"
    return res.status(200).send("OK");
  }

  // codigosms vem vazio quando é keyword
  await salvarRecebida({ clientRef: codigosms, celular, shortcode, mensagem, data, canal });
  res.status(200).send("OK");
});

app.listen(3000);