Framework PHPGuide · SDK officiel bientôt

Envoyez des SMS en Tunisie depuis Laravel avec le client HTTP intégré.

Le client Http de Laravel gère l’authentification, les délais et les erreurs pour vous. Ajoutez votre clé dans le .env et envoyez un SMS depuis un contrôleur, un job ou une notification. Le package Laravel officiel arrive.

Ce que ça fait

Configuration dans config/services.php et le fichier .env.
Envoi depuis un job en file d’attente pour ne jamais ralentir vos requêtes.
Idempotency-Key basé sur l’identifiant de la commande : un job relancé n’envoie pas deux fois.
Exceptions claires avec ->throw() en cas d’erreur 4xx ou 5xx.

Mise en place

1Ajoutez la clé sendimo dans config/services.php et SENDIMO_API_KEY dans .env.
2Appelez l’API avec Http::withToken() depuis votre code.
3Placez l’envoi dans un job (ShouldQueue) pour les envois en masse.
4Recevez les statuts dans une route webhook et mettez à jour vos modèles.

ConfigurationPHP

// config/services.php
'sendimo' => [
    'key' => env('SENDIMO_API_KEY'),
],

// .env
SENDIMO_API_KEY=sk_live_...

Envoyer un SMSLaravel

use Illuminate\Support\Facades\Http;

$response = Http::withToken(config('services.sendimo.key'))
    ->withHeaders(['Idempotency-Key' => "order-{$order->id}-confirm"])
    ->timeout(10)
    ->post('https://api.sendimo.tn/v1/messages', [
        'to'        => $order->phone,
        'from'      => 'SENDIMO',
        'text'      => "Votre commande #{$order->id} est confirmée.",
        'reference' => "order-{$order->id}",
    ])
    ->throw(); // 4xx/5xx → RequestException

$messageId = $response->json('id'); // msg_01HF8Z3K9QX2

Réponse 202 AcceptedJSON

{
  "id": "msg_01HF8Z3K9QX2",
  "status": "queued",
  "to": "+21620123456",
  "from": "SENDIMO",
  "text": "Votre code est 482913. Il expire dans 5 minutes.",
  "encoding": "GSM-7",
  "segments": 1,
  "network": "ooredoo",
  "cost": { "amount": "0.140", "currency": "TND" },
  "reference": "order-4821",
  "scheduled_at": null,
  "created_at": "2026-10-30T09:15:00Z"
}