Diffusez à des milliers d'abonnés, répondez un par un

Envoi unitaire, puis envoi en masse.

import requests

base = 'https://app.sparrowmessage.com/api/v1'

# — Authentification
jeton = requests.post(f'{base}/login', json={
    'email': '[email protected]',
    'password': 'votre-mot-de-passe',
}).json()['api_token']

entetes = {'Authorization': f'Bearer {jeton}', 'Accept': 'application/json'}

# — Envoi d'un message
r = requests.post(f'{base}/telegram/send/one', headers=entetes, json={
    'recipient':     '718294106203941',
    'text':      'Votre code de vérification est 385 214.',
    'notifyurl': 'https://votre-site.ma/sparrow/statut',
}).json()

print('Message envoyé' if r['code'] == 'OK' else f"Échec : {r['error']}")

# — Envoi en masse : une seule requête, plusieurs destinataires
requests.post(f'{base}/telegram/send/bulk', headers=entetes, json={
    'phones': ['718294106203941', '+2126YYYYYYYY'],
    'text':   'Soldes : -20 % jusqu\'à dimanche. STOP au 36000',
})

# — Statut d'un envoi, à partir de l'identifiant renvoyé
statut = requests.post(f'{base}/telegram/status', headers=entetes, json={
    'message_id': '8f21c4',
}).json()
print(statut['result'])

Node 18 ou plus récent : fetch est natif.

const base = 'https://app.sparrowmessage.com/api/v1';

// — Authentification
const { api_token } = await fetch(`${base}/login`, {
  method:  'POST',
  headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
  body:    JSON.stringify({
    email:    '[email protected]',
    password: 'votre-mot-de-passe',
  }),
}).then(r => r.json());

const entetes = {
  'Content-Type': 'application/json',
  Accept:         'application/json',
  Authorization: `Bearer ${api_token}`,
};

// — Envoi d'un message
const reponse = await fetch(`${base}/telegram/send/one`, {
  method:  'POST',
  headers: entetes,
  body: JSON.stringify({
    phone:     '718294106203941',
    text:      'Votre code de vérification est 385 214.',
    notifyurl: 'https://votre-site.ma/sparrow/statut',
  }),
}).then(r => r.json());

console.log(reponse.code === 'OK' ? 'Message envoyé' : `Échec : ${reponse.error}`);

// — Envoi en masse
await fetch(`${base}/telegram/send/bulk`, {
  method:  'POST',
  headers: entetes,
  body: JSON.stringify({
    phones: ['718294106203941', '+2126YYYYYYYY'],
    text:   'Soldes : -20 % jusqu\'à dimanche. STOP au 36000',
  }),
});

.NET 6 ou plus récent.

using System.Net.Http.Json;

var http = new HttpClient { BaseAddress = new Uri("https://app.sparrowmessage.com/api/v1/") };

// — Authentification
var auth = await http.PostAsJsonAsync("login", new {
    email    = "[email protected]",
    password = "votre-mot-de-passe",
});
var jeton = (await auth.Content.ReadFromJsonAsync<Dictionary<string, string>>())["api_token"];
http.DefaultRequestHeaders.Authorization = new("Bearer", jeton);

// — Envoi d'un message
var envoi = await http.PostAsJsonAsync("sms/send/one", new {
    phone     = "718294106203941",
    text      = "Votre code de vérification est 385 214.",
    notifyurl = "https://votre-site.ma/sparrow/statut",
});

var resultat = await envoi.Content.ReadFromJsonAsync<Dictionary<string, object>>();
Console.WriteLine(resultat["code"].ToString() == "OK" ? "Message envoyé" : $"Échec : {resultat["error"]}");

// — Envoi en masse
await http.PostAsJsonAsync("sms/send/bulk", new {
    phones = new[] { "718294106203941", "+2126YYYYYYYY" },
    text   = "Soldes : -20 % jusqu'à dimanche. STOP au 36000",
});

Java 11 ou plus récent, client HTTP natif.

import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var base   = "https://app.sparrowmessage.com/api/v1";

// — Authentification
var auth = HttpRequest.newBuilder(URI.create(base + "/login"))
    .header("Content-Type", "application/json")
    .header("Accept", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"email":"[email protected]","password":"votre-mot-de-passe"}"""))
    .build();

var jeton = extraire(client.send(auth, HttpResponse.BodyHandlers.ofString()).body(), "api_token");

// — Envoi d'un message
var envoi = HttpRequest.newBuilder(URI.create(base + "/telegram/send/one"))
    .header("Content-Type", "application/json")
    .header("Accept", "application/json")
    .header("Authorization", "Bearer " + jeton)
    .POST(HttpRequest.BodyPublishers.ofString("""
        {"recipient":"718294106203941",
         "text":"Votre code de vérification est 385 214.",
         "notifyurl":"https://votre-site.ma/sparrow/statut"}"""))
    .build();

System.out.println(client.send(envoi, HttpResponse.BodyHandlers.ofString()).body());

À copier tel quel dans un terminal.

# — 1. Obtenir le jeton
curl -X POST https://app.sparrowmessage.com/api/v1/login \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -d '{"email":"[email protected]","password":"votre-mot-de-passe"}'

# Réponse : {"code":"OK","api_token":"eyJ0eXAiOiJKV1Qi..."}

# — 2. Envoyer un message
curl -X POST https://app.sparrowmessage.com/api/v1/telegram/send/one \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $JETON" \
     -d '{"recipient":"718294106203941",
          "text":"Votre code de vérification est 385 214.",
          "notifyurl":"https://votre-site.ma/sparrow/statut"}'

# — 3. Recevoir les messages entrants
curl -X POST https://app.sparrowmessage.com/api/v1/telegram/send/bulk \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $JETON" \
     -d '{"phones":["718294106203941","+2126YYYYYYYY"],
          "text":"Rappel : votre rendez-vous est demain a 14h30."}'

# — 4. Statut d'un envoi
curl -X POST https://app.sparrowmessage.com/api/v1/telegram/status \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $JETON" \
     -d '{"message_id":"8f21c4"}'

# — 5. Statut d'une liste
curl -X POST https://app.sparrowmessage.com/api/v1/telegram/status/bulk \
     -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $JETON" \
     -d '{"messages_id":["8f21c4","8f21c5"]}'