Documentation API Intech SMS

Intégrez facilement l'envoi de SMS en masse dans vos applications avec l'API REST Intech SMS. Solution robuste et fiable pour vos communications automatisées.

Collection Postman disponible
Téléchargez la collection Postman complète : INTECH-SMS.postman_collection.json

Rapide et Simple

API REST simple avec un seul endpoint pour l'envoi de SMS

International

Support pour les numéros de téléphone internationaux

Envoi en masse

Envoyez des SMS à plusieurs destinataires en une seule requête

Assistance IA pour l'intégration

Besoin d'aide personnalisée ? Utilisez des assistants IA comme Claude ou ChatGPT pour vous guider dans l'intégration Intech SMS.

Prompt recommandé pour l'IA

Copiez et collez ce prompt dans Claude, ChatGPT ou tout autre assistant IA :

Astuce
Ce prompt garantit que l'IA utilisera uniquement la documentation officielle Intech SMS comme source d'information. 
Could you please help me implement Intech SMS API integration in my application? I need assistance with the following:

CRITICAL INSTRUCTION: Base ALL your recommendations EXCLUSIVELY on these two sources:
- The official Intech SMS documentation at https://doc.intech.sn/doc_intech_sms.php
- The Intech SMS Postman collection at https://doc.intech.sn/INTECH-SMS.postman_collection.json

DO NOT use any other sources of information beyond these two specified resources.

Please help me with:
1. Setting up the Intech SMS API in my backend (including authentication and configuration)
2. Sample code for sending SMS to single and multiple recipients
3. Proper phone number formatting for international numbers
4. Error handling and response processing
5. Best practices for SMS content and sender names
6. Integration examples for my specific programming language/framework

Please first ask me about my technology stack to provide the most accurate implementation guidance.

If any information is not available in the specified documentation sources, please explicitly state this rather than using other sources or making assumptions.

Avantages de l'assistance IA

  • Code personnalisé pour votre stack technologique
  • Explications détaillées étape par étape
  • Résolution de problèmes spécifiques
  • Meilleures pratiques SMS
  • Gestion des erreurs

Frameworks supportés

  • Laravel / Symfony (PHP)
  • Django / FastAPI (Python)
  • Express.js / NestJS (Node.js)
  • Spring Boot (Java)
  • Flutter / React Native (Mobile)

Authentification

L'API Intech SMS utilise une clé d'application (app_key) pour l'authentification. Cette clé doit être incluse dans le corps de chaque requête.

Important
Gardez votre clé d'application secrète et ne l'exposez jamais dans du code côté client.

Paramètre d'authentification

Paramètre Type Description Requis
app_key String Votre clé d'application Intech SMS Oui

URL de base

Toutes les requêtes API doivent être envoyées à l'URL de base suivante :

URL de base
https://gateway.intechsms.sn

Format des numéros de téléphone

Il est crucial de respecter le format international pour les numéros de téléphone.

Format correct

  • +221781089817 (Sénégal)
  • +221766144307 (Sénégal)
  • +33612345678 (France)
  • +1234567890 (États-Unis)

Format : +[code_pays][numero]

Format incorrect

  • 777293282 (sans indicatif)
  • 0781089817 (avec 0 initial)
  • 221781089817 (sans +)

Erreur : "Le numero est invalide !. Respecter le format internationnal"

Envoi de SMS

L'endpoint principal pour envoyer des SMS via l'API Intech SMS.

Endpoint

POST /api/send-sms
URL complète : https://gateway.intechsms.sn/api/send-sms

Paramètres de la requête

Paramètre Type Description Requis
app_key String Votre clé d'application Oui
sender String Nom de l'expéditeur (max 11 caractères) Oui
content String Contenu du message SMS Oui
msisdn Array Liste des numéros de téléphone (format international) Oui

Exemple de requête

{
    "app_key": "67E811A94F74867E811A94F74A",
    "sender": "INTECHSMS",
    "content": "Bonjour, voici votre message de test !",
    "msisdn": [
        "+221777293282",
        "+221766144307"
    ]
}

Codes de réponse

L'API retourne différents codes de statut selon le résultat de la requête.

Succès (201)

Description : SMS envoyé avec succès

{
    "code": 201,
    "error": false,
    "msg": "Les donnés ont été sauvegardés avec succès",
    "data": []
}

Erreur (400)

Description : Données invalides

{
    "code": 400,
    "error": true,
    "msg": "Les donnés envoyés sont invalides",
    "data": {
        "777293282": "Le numero est invalide !. Respecter le format internationnal "
    }
}

Gestion des erreurs

Voici les principales erreurs que vous pouvez rencontrer et comment les gérer.

Erreurs courantes

  • Format de numéro invalide : Utilisez le format international (+code_pays)
  • Clé d'application invalide : Vérifiez votre app_key
  • Contenu vide : Le message ne peut pas être vide
  • Expéditeur trop long : Maximum 11 caractères pour le sender

Bonnes pratiques

  • Toujours valider les numéros avant envoi
  • Gérer les erreurs dans votre code
  • Limiter la longueur des messages (160 caractères)
  • Utiliser un sender identifiable

Exemple cURL

Exemple d'envoi de SMS avec cURL depuis la ligne de commande.

Commande cURL

curl -X POST https://gateway.intechsms.sn/api/send-sms \
  -H "Content-Type: application/json" \
  -d '{
    "app_key": "VOTRE_CLE_APPLICATION",
    "sender": "INTECHSMS",
    "content": "Bonjour, voici votre message de test !",
    "msisdn": [
        "+221777293282",
        "+221766144307"
    ]
  }'

Exemple JavaScript

Intégration avec JavaScript/TypeScript pour applications web.

Avec fetch API

async function sendSMS() {
    const smsData = {
        app_key: "VOTRE_CLE_APPLICATION",
        sender: "INTECHSMS",
        content: "Bonjour, voici votre message de test !",
        msisdn: [
            "+221777293282",
            "+221766144307"
        ]
    };

    try {
        const response = await fetch('https://gateway.intechsms.sn/api/send-sms', {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json',
            },
            body: JSON.stringify(smsData)
        });

        const result = await response.json();
        
        if (result.error) {
            console.error('Erreur:', result.msg);
            console.error('Détails:', result.data);
        } else {
            console.log('SMS envoyé avec succès:', result.msg);
        }
    } catch (error) {
        console.error('Erreur réseau:', error);
    }
}

Avec axios

const axios = require('axios');

async function sendSMS() {
    try {
        const response = await axios.post('https://gateway.intechsms.sn/api/send-sms', {
            app_key: "VOTRE_CLE_APPLICATION",
            sender: "INTECHSMS",
            content: "Bonjour, voici votre message de test !",
            msisdn: [
                "+221777293282",
                "+221766144307"
            ]
        });

        console.log('SMS envoyé avec succès:', response.data);
    } catch (error) {
        if (error.response) {
            console.error('Erreur API:', error.response.data);
        } else {
            console.error('Erreur réseau:', error.message);
        }
    }
}

Exemple PHP

Intégration avec PHP pour applications web backend.

Avec cURL

<?php
function sendSMS($appKey, $sender, $content, $numbers) {
    $url = 'https://gateway.intechsms.sn/api/send-sms';
    
    $data = [
        'app_key' => $appKey,
        'sender' => $sender,
        'content' => $content,
        'msisdn' => $numbers
    ];

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

    return [
        'success' => $httpCode === 200,
        'data' => json_decode($response, true)
    ];
}

// Utilisation
$result = sendSMS(
    'VOTRE_CLE_APPLICATION',
    'INTECHSMS',
    'Bonjour, voici votre message de test !',
    ['+221777293282', '+221766144307']
);

if ($result['success']) {
    if ($result['data']['error']) {
        echo "Erreur: " . $result['data']['msg'];
    } else {
        echo "SMS envoyé avec succès: " . $result['data']['msg'];
    }
} else {
    echo "Erreur de connexion";
}
?>

Exemple Python

Intégration avec Python pour applications backend.

Avec requests

import requests
import json

def send_sms(app_key, sender, content, numbers):
    url = 'https://gateway.intechsms.sn/api/send-sms'
    
    data = {
        'app_key': app_key,
        'sender': sender,
        'content': content,
        'msisdn': numbers
    }
    
    headers = {
        'Content-Type': 'application/json'
    }
    
    try:
        response = requests.post(url, json=data, headers=headers)
        result = response.json()
        
        if result.get('error'):
            print(f"Erreur: {result.get('msg')}")
            print(f"Détails: {result.get('data')}")
        else:
            print(f"SMS envoyé avec succès: {result.get('msg')}")
            
        return result
        
    except requests.exceptions.RequestException as e:
        print(f"Erreur de connexion: {e}")
        return None

# Utilisation
result = send_sms(
    'VOTRE_CLE_APPLICATION',
    'INTECHSMS',
    'Bonjour, voici votre message de test !',
    ['+221777293282', '+221766144307']
)

Exemple Node.js

Intégration avec Node.js pour applications backend.

Avec node-fetch

const fetch = require('node-fetch');

async function sendSMS(appKey, sender, content, numbers) {
    const url = 'https://gateway.intechsms.sn/api/send-sms';
    
    const data = {
        app_key: appKey,
        sender: sender,
        content: content,
        msisdn: numbers
    };

    try {
        const response = await fetch(url, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json',
            },
            body: JSON.stringify(data)
        });

        const result = await response.json();
        
        if (result.error) {
            console.error('Erreur:', result.msg);
            console.error('Détails:', result.data);
        } else {
            console.log('SMS envoyé avec succès:', result.msg);
        }
        
        return result;
        
    } catch (error) {
        console.error('Erreur de connexion:', error);
        return null;
    }
}

// Utilisation
sendSMS(
    'VOTRE_CLE_APPLICATION',
    'INTECHSMS',
    'Bonjour, voici votre message de test !',
    ['+221777293282', '+221766144307']
);

Testeur API

Testez l'API Intech SMS directement depuis cette page.

Formulaire de test