One API for WhatsApp, Instagram, Messenger and live chat.

cURL

# Staging; for live use https://messaging.uppu.net/v1 and a uppu_live_ key.
# Never commit or log the key.
export UPPU_API_BASE="https://messaging-staging.uppu.net/v1"
export UPPU_API_KEY="uppu_test_XXXXXXXXXXXX_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

PHP

<?php
// PHP 8+, cURL extension. Returns ['status' => int, 'body' => array|null].
function uppu_request(string $method, string $path, ?array $body = null, ?string $idempotencyKey = null): array
{
    $base = rtrim(getenv('UPPU_API_BASE') ?: 'https://messaging-staging.uppu.net/v1', '/');
    $headers = ['Authorization: Bearer ' . getenv('UPPU_API_KEY'), 'Accept: application/json'];
    if ($body !== null) {
        $headers[] = 'Content-Type: application/json';
    }
    if ($idempotencyKey !== null) {
        $headers[] = 'Idempotency-Key: ' . $idempotencyKey;
    }
    $ch = curl_init($base . '/' . ltrim($path, '/'));
    curl_setopt_array($ch, [
        CURLOPT_CUSTOMREQUEST  => $method,
        CURLOPT_HTTPHEADER     => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CONNECTTIMEOUT => 5,
        CURLOPT_TIMEOUT        => 20,
    ]);
    if ($body !== null) {
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES));
    }
    $raw = curl_exec($ch);
    $status = (int) curl_getinfo($ch, CURLINFO_RESPONSE_CODE);   // 0: network error, retry with the same key
    return ['status' => $status, 'body' => is_string($raw) && $raw !== '' ? json_decode($raw, true) : null];
}

Node.js

// Node.js 18+, built-in fetch. Returns { status, data, retryAfter }.
const BASE = process.env.UPPU_API_BASE ?? 'https://messaging-staging.uppu.net/v1';

export async function uppuRequest(method, path, body, idempotencyKey) {
  const headers = { Authorization: `Bearer ${process.env.UPPU_API_KEY}`, Accept: 'application/json' };
  if (body !== undefined) headers['Content-Type'] = 'application/json';
  if (idempotencyKey) headers['Idempotency-Key'] = idempotencyKey;
  const res = await fetch(`${BASE}/${path}`, {
    method,
    headers,
    body: body === undefined ? undefined : JSON.stringify(body),
    signal: AbortSignal.timeout(20000),
  });
  const data = await res.json().catch(() => null);
  return { status: res.status, data, retryAfter: res.headers.get('retry-after') };
}

Python

# Python 3.9+, standard library only. Returns (status, parsed JSON or None).
import json
import os
import urllib.error
import urllib.request

BASE = os.environ.get("UPPU_API_BASE", "https://messaging-staging.uppu.net/v1")


def uppu_request(method, path, body=None, idempotency_key=None):
    headers = {"Authorization": f"Bearer {os.environ['UPPU_API_KEY']}", "Accept": "application/json"}
    data = None
    if body is not None:
        data = json.dumps(body, ensure_ascii=False).encode("utf-8")
        headers["Content-Type"] = "application/json"
    if idempotency_key:
        headers["Idempotency-Key"] = idempotency_key
    request = urllib.request.Request(f"{BASE}/{path}", data=data, headers=headers, method=method)
    try:
        with urllib.request.urlopen(request, timeout=20) as response:
            return response.status, json.loads(response.read() or b"null")
    except urllib.error.HTTPError as error:   # 4xx and 5xx carry the error envelope
        try:
            return error.code, json.loads(error.read() or b"null")
        except ValueError:
            return error.code, None

cURL

curl -sS "$UPPU_API_BASE/channels" \
  -H "Authorization: Bearer $UPPU_API_KEY" \
  -H "Accept: application/json"

PHP

$r = uppu_request('GET', 'channels');
foreach ($r['body']['data'] ?? [] as $channel) {
    echo $channel['id'], ' ', $channel['type'], ' ', $channel['sending'], PHP_EOL;
}

Node.js

const { data: page } = await uppuRequest('GET', 'channels');
for (const channel of page.data) {
  console.log(channel.id, channel.type, channel.sending);
}

Python

status, page = uppu_request("GET", "channels")
for channel in page["data"]:
    print(channel["id"], channel["type"], channel["sending"])

cURL

curl -sS "$UPPU_API_BASE/templates?channel_id=01j9z0ch5k2m4n6p8q0r2s4t6v&status=APPROVED" \
  -H "Authorization: Bearer $UPPU_API_KEY"

PHP

$query = http_build_query(['channel_id' => '01j9z0ch5k2m4n6p8q0r2s4t6v', 'status' => 'APPROVED']);
$r = uppu_request('GET', 'templates?' . $query);
foreach ($r['body']['data'] ?? [] as $template) {
    // sendable, unsendable_reason, parameters and a ready send_example
    echo $template['name'], ' ', $template['language'], ' ', $template['sendable'] ? 'ok' : $template['unsendable_reason'], PHP_EOL;
}

Node.js

const query = new URLSearchParams({ channel_id: '01j9z0ch5k2m4n6p8q0r2s4t6v', status: 'APPROVED' });
const { data: page } = await uppuRequest('GET', `templates?${query}`);
for (const t of page.data) {
  console.log(t.name, t.language, t.sendable ? 'ok' : t.unsendable_reason);
}

Python

from urllib.parse import urlencode

query = urlencode({"channel_id": "01j9z0ch5k2m4n6p8q0r2s4t6v", "status": "APPROVED"})
status, page = uppu_request("GET", f"templates?{query}")
for t in page["data"]:
    print(t["name"], t["language"], "ok" if t["sendable"] else t["unsendable_reason"])

cURL

curl -sS -X POST "$UPPU_API_BASE/messages" \
  -H "Authorization: Bearer $UPPU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1001-shipped" \
  -d '{"channel_id": "01j9z0ch5k2m4n6p8q0r2s4t6v",
       "to": {"contact_id": "01j8x7ct5k2m4n6p8q0r2s4t6v"},
       "content": {"type": "template",
                   "template": {"name": "order_update", "language": "en",
                                "body": {"parameters": ["Ayşe", "1001"]}}},
       "client_reference": "order-1001"}'

PHP

// One logical send = one key. Retry with the SAME key and the SAME body.
$r = uppu_request('POST', 'messages', [
    'channel_id'       => '01j9z0ch5k2m4n6p8q0r2s4t6v',
    'to'               => ['contact_id' => '01j8x7ct5k2m4n6p8q0r2s4t6v'],
    'content'          => ['type' => 'template', 'template' => [
        'name' => 'order_update', 'language' => 'en',
        'body' => ['parameters' => ['Ayşe', '1001']],
    ]],
    'client_reference' => 'order-1001',
], 'order-1001-shipped');

Node.js

// One logical send = one key. Retry with the SAME key and the SAME body.
const { status, data } = await uppuRequest('POST', 'messages', {
  channel_id: '01j9z0ch5k2m4n6p8q0r2s4t6v',
  to: { contact_id: '01j8x7ct5k2m4n6p8q0r2s4t6v' },
  content: { type: 'template', template: {
    name: 'order_update', language: 'en', body: { parameters: ['Ayşe', '1001'] },
  } },
  client_reference: 'order-1001',
}, 'order-1001-shipped');

Python

# One logical send = one key. Retry with the SAME key and the SAME body.
status, message = uppu_request("POST", "messages", {
    "channel_id": "01j9z0ch5k2m4n6p8q0r2s4t6v",
    "to": {"contact_id": "01j8x7ct5k2m4n6p8q0r2s4t6v"},
    "content": {"type": "template", "template": {
        "name": "order_update", "language": "en",
        "body": {"parameters": ["Ayşe", "1001"]},
    }},
    "client_reference": "order-1001",
}, idempotency_key="order-1001-shipped")

cURL

curl -sS -X POST "$UPPU_API_BASE/messages" \
  -H "Authorization: Bearer $UPPU_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: reply-01jab3t6ms2m4n6p8q0r2s4t6v" \
  -d '{"channel_id": "01j9z0ch5k2m4n6p8q0r2s4t6v",
       "to": {"contact_id": "01j8x7ct5k2m4n6p8q0r2s4t6v"},
       "content": {"type": "text", "text": {"body": "Your order is on its way."}},
       "client_reference": "order-1001"}'

PHP

$r = uppu_request('POST', 'messages', [
    'channel_id'       => '01j9z0ch5k2m4n6p8q0r2s4t6v',
    'to'               => ['contact_id' => '01j8x7ct5k2m4n6p8q0r2s4t6v'],
    'content'          => ['type' => 'text', 'text' => ['body' => 'Your order is on its way.']],
    'client_reference' => 'order-1001',
], 'reply-01jab3t6ms2m4n6p8q0r2s4t6v');

if ($r['status'] === 202 || $r['status'] === 200) {
    $messageId = $r['body']['id'];          // store it; statuses arrive as message.status webhooks
} else {
    $code = $r['body']['error']['code'] ?? 'http_' . $r['status'];   // e.g. window_closed
}

Node.js

const { status, data } = await uppuRequest('POST', 'messages', {
  channel_id: '01j9z0ch5k2m4n6p8q0r2s4t6v',
  to: { contact_id: '01j8x7ct5k2m4n6p8q0r2s4t6v' },
  content: { type: 'text', text: { body: 'Your order is on its way.' } },
  client_reference: 'order-1001',
}, 'reply-01jab3t6ms2m4n6p8q0r2s4t6v');

if (status === 202 || status === 200) {
  console.log('stored', data.id);           // statuses arrive as message.status webhooks
} else {
  console.log('refused', data?.error?.code); // e.g. window_closed
}

Python

status, message = uppu_request("POST", "messages", {
    "channel_id": "01j9z0ch5k2m4n6p8q0r2s4t6v",
    "to": {"contact_id": "01j8x7ct5k2m4n6p8q0r2s4t6v"},
    "content": {"type": "text", "text": {"body": "Your order is on its way."}},
    "client_reference": "order-1001",
}, idempotency_key="reply-01jab3t6ms2m4n6p8q0r2s4t6v")

if status in (200, 202):
    print("stored", message["id"])          # statuses arrive as message.status webhooks
else:
    print("refused", message["error"]["code"])   # e.g. window_closed