💬 Configuration SMS AI4CALL
Guide complet pour intégrer SMS avec AI4CALL : envoyez des confirmations, rappels et notifications automatiques par SMS pendant les appels avec système prépayé
Allez dans "MARKET" → "Marketplace Plugin" et cliquez sur Acheter de "SMS AI4CALL" → PAY
Allez dans "MARKET" → "Mes Plugins" et cliquez sur Configurer de "SMS AI4CALL"
🚀 Navigation rapide :
⚠️ Services de tiers
Les intégrations décrites font référence à des services de tiers.
Les limites de débit, les modes d'authentification, les configurations techniques, les coûts et les politiques sont définis exclusivement par les fournisseurs respectifs et peuvent changer au fil du temps.
Les coûts des services externes sont supportés directement par l'utilisateur final auprès des fournisseurs des services eux-mêmes et ne sont en aucun cas gérés ou intermédiés par notre portail (par exemple, Meta ou d'autres fournisseurs pour WhatsApp, Zapier, Calendly, etc.).
Qu'est-ce que cela signifie :
- ❌ vous NE pouvez PAS personnaliser l'alias de l'expéditeur avec le nom de votre entreprise
- ❌ Le client reçoit un SMS avec l'expéditeur "AI4CALL", pas "Cabinet Médical" ou "Agence XYZ"
- ⚠️ Limitation technique de l'opérateur SMS - non modifiable actuellement
Solution de contournement recommandée :
- ✅ Incluez le nom de l'entreprise dans le TEXTE du SMS
- ✅ Exemple : "AI4CALL pour Cabinet Dentaire Rossi : rendez-vous confirmé mardi 15 à 10h"
- ✅ Le client comprend la provenance même avec un expéditeur générique
Futur : la personnalisation d'alias custom est sur la roadmap - contactez le support AI4CALL pour les mises à jour.
Avantages :
- ✅ universel : fonctionne sur TOUS les mobiles (même les téléphones basiques sans internet)
- ✅ taux de livraison très élevé : 99% de livraison garantie
- ✅ AUCUNE app requise : arrive nativement
- ✅ faible latence : livraison 2-30 secondes
- ✅ taux de lecture élevé : ~90% des SMS lus en moins de 3 minutes
Inconvénients :
- ⚠️ payant : €0.035-0.05 par SMS
- ⚠️ 160 caractères max (texte pur, pas de média)
- ⚠️ PAS de liens cliquables natifs (seulement sur smartphones modernes)
- ⚠️ expéditeur fixe "AI4CALL" actuellement
Quand utiliser les SMS :
→ notifications critiques urgentes (OTP, alertes de sécurité)
→ clients sans smartphone/WhatsApp
→ backup de secours si WhatsApp/Email échouent
→ confirmations où la livraison garantie est critique
→ démographie senior (préfèrent les SMS)
Quand NE PAS utiliser les SMS :
→ messages longs >160 caractères (utilisez Email)
→ contenus avec médias/images (utilisez WhatsApp)
→ liens importants à cliquer (utilisez Email/WhatsApp)
→ volumes très élevés quotidiens (coûts excessifs)
Qu'est-ce que l'intégration SMS et comment ça fonctionne
L'intégration SMS permet à l'assistant AI4CALL d'envoyer des messages texte sur les téléphones mobiles pendant ou après les appels via le réseau des opérateurs mobiles.
→ vous achetez du crédit SMS à l'avance (100, 500, 1000 SMS)
→ chaque envoi décrémente le compteur automatiquement
→ quand ils sont épuisés : vous devez acheter un nouveau pack
→ SMS prépayés n'expirent JAMAIS
Envoi one-way (sortie uniquement) :
→ l'assistant peut ENVOYER des SMS aux clients
→ les clients NE peuvent PAS répondre (numéro non bidirectionnel)
→ idéal pour : confirmations, rappels, notifications, alertes
Expéditeur fixe "AI4CALL" :
→ tous les SMS affichent l'expéditeur "AI4CALL"
→ NON personnalisable avec le nom de l'entreprise actuellement
→ solution : incluez le nom de l'entreprise dans le texte du message
Livraison garantie :
→ livraison via le réseau des opérateurs mobiles (Vodafone, TIM, Wind, etc.)
→ 99% de taux de livraison
→ latence de 2-30 secondes typiquement
[Le client appelle le cabinet pour réserver]
↓
[L'assistant AI4CALL gère la réservation]
↓
[Collecte : nom, numéro de mobile, date/heure du rendez-vous]
↓
[Fin de l'appel]
↓
[L'AI invoque : send_sms]
↓
[Paramètres :
- dst : numéro de mobile du client
- txt : "AI4CALL pour Cabinet Dr. Rossi : rendez-vous
confirmé mardi 15 mars à 10:00.
Via Roma 1, Milan"]
↓
[Le système envoie le SMS via l'opérateur mobile]
↓
[Le client reçoit le SMS en moins de 30 secondes]
↓
[Le compteur de SMS disponibles décrémente : 90 → 89]
Avantage : confirmation immédiate sur l'appareil que le client a toujours sur lui (mobile). Fonctionne même sans smartphone/internet.
Pack Basique : 100 SMS à €5.00
→ coût par SMS : €0.05
→ idéal pour : test, utilisation occasionnelle d'un seul cabinet
Pack Standard : 500 SMS à €20.00
→ coût par SMS : €0.04
→ idéal pour : utilisation moyenne, campagnes petites/moyennes
Pack Premium : 1000 SMS à €35.00
→ coût par SMS : €0.035
→ idéal pour : utilisation intensive, volumes élevés
Attention messages longs : si le texte SMS >160 caractères, il est divisé en multiples SMS facturés séparément
→ 161-320 caractères = 2 SMS facturés
→ 321-480 caractères = 3 SMS facturés
Best practice : gardez sous 160 caractères pour maximiser l'efficacité
Acheter un pack SMS prépayé
Avant de pouvoir envoyer des SMS, vous devez acheter du crédit via l'un des packs prépayés disponibles.
- Sélectionnez "SMS AI4CALL" dans la liste de vos Plugins
- Section "SMS Disponibles" :
→ affiche le compteur de SMS restants (ex. "90")
→ si 0 ou peu : un rechargement est nécessaire - Section "Packs SMS Disponibles" :
→ affiche 3 cartes de packs avec détails - Choisissez le pack adapté :
- Basique 100 SMS €5 : test ou utilisation très limitée
- Standard 500 SMS €20 : recommandé pour débuter (meilleur rapport qualité/prix)
- Premium 1000 SMS €35 : volumes élevés (>30 SMS/jour)
- Cliquez sur le bouton "ACHETER" sur le pack choisi
- Le système redirige vers le checkout de paiement sécurisé
- Complétez le paiement (carte de crédit/PayPal/virement)
- Après paiement confirmé :
→ SMS ajoutés automatiquement au solde
→ compteur "SMS Disponibles" mis à jour
→ l'achat apparaît dans "Historique des Achats" - Cliquez "ACTUALISER SMS RESTANTS" si le compteur ne se rafraîchit pas automatiquement
- ✅ SMS Disponibles : compteur mis à jour (ex. 90 → 590 si Standard acheté)
- ✅ Historique des Achats : nouvelle ligne avec date, SMS achetés, prix
- ✅ l'outil send_sms est maintenant fonctionnel
Note : les SMS prépayés n'expirent JAMAIS. Vous pouvez acheter plusieurs fois - le crédit s'additionne.
Exemple : vous avez 90 SMS, vous achetez Standard 500 → le total devient 590 SMS disponibles.
Formule : (appels/jour × % qui reçoivent des SMS × jours ouvrables/mois)
Exemple Cabinet Médical :
→ 20 rendez-vous/jour
→ 80% des clients reçoivent une confirmation SMS
→ 22 jours ouvrables/mois
→ besoin : 20 × 0.8 × 22 = 352 SMS/mois
→ pack recommandé : Standard 500 SMS (couvre 1+ mois)
Exemple Agence d'Assurances :
→ 50 appels/jour
→ 30% reçoivent des SMS (les autres préfèrent l'email)
→ 22 jours ouvrables/mois
→ besoin : 50 × 0.3 × 22 = 330 SMS/mois
→ pack recommandé : Standard 500 SMS
Conseil : commencez avec Standard 500, surveillez la consommation le premier mois, adaptez ensuite.
Activer l'outil send_sms
Après avoir acheté du crédit SMS, activez l'outil send_sms pour permettre à l'assistant d'envoyer des messages.
- Sélectionnez "SMS" dans la liste de vos plugins :
→ vous voyez l'outil send_sms avec checkbox
→ description : "Envoyer un message SMS via BeeVoIP ou alias spécifié" - Cochez la checkbox ☑️ send_sms
- Paramètres de l'outil visibles :
- alias : alias de l'expéditeur (défaut : ai4call) - FIXE actuellement
- dst : numéro de destination (obligatoire)
- txt : texte du message SMS (obligatoire)
- Cliquez "SAUVEGARDER LA CONFIGURATION"
- ✅ L'outil send_sms est maintenant disponible pour l'assistant !
- ✅ checkbox send_sms cochée
- ✅ crédit SMS disponible >0
- ✅ outil prêt à être utilisé dans le prompt
Test rapide : appelez l'assistant, demandez "envoie-moi un SMS de test". Vous devriez recevoir un message en moins de 30 secondes.
→ même s'il est présent dans la configuration, il n'est PAS modifiable
→ tous les SMS envoyés affichent l'expéditeur "AI4CALL"
→ spécifier un alias différent dans l'appel de l'outil n'a pas d'effet
Implication : NE perdez pas de temps à essayer de personnaliser l'alias - cela ne fonctionnera pas.
Solution : incluez l'identification de l'entreprise dans le TEXTE du SMS, pas dans l'alias.
Optimisez le texte SMS pour une efficacité maximale
SMS a une limite de 160 caractères - chaque mot compte. Optimisez le texte pour maximiser les informations utiles tout en minimisant les coûts.
✅ Exemple BON (152 caractères) :
AI4CALL pour Cabinet Dr. Rossi : rendez-vous mardi 15 mars à 10:00, Via Roma 1 Milan. Pour annulation appelez le 02-1234567
❌ Exemple MAUVAIS (187 caractères = 2 SMS facturés !) :
AI4CALL pour Cabinet Dentaire Dr. Rossi : cher client, nous vous confirmons que votre rendez-vous est fixé pour le mardi 15 mars 2025 à 10:00 dans notre cabinet
Techniques d'abréviation intelligentes :
- "rendez-vous" → "rdv" (économie de 10 caractères)
- "cher client" → omettre (économie de 15 caractères)
- "2025" → omettre l'année si évidente (économie de 5 caractères)
- "dans notre cabinet" → adresse directe (économie de 15 caractères)
- "nous vous confirmons que" → omettre formalités excessives
Structure SMS efficace :
1. Identification : "AI4CALL pour [Nom Entreprise] :" (20-30 caractères)
2. Message core : action/info principale (60-80 caractères)
3. Détails essentiels : date/heure/lieu (40-50 caractères)
4. Call-to-action : quoi faire si nécessaire (20-30 caractères)
AI4CALL pour [Entreprise] : rdv [jour] [date] à [hh:mm], [adresse]. Annulation : [téléphone]
→ exemple : "AI4CALL pour Cabinet Rossi : rdv mar 15/3 à 10:00, Via Roma 1 MI. Annulation : 02-123456"
Template 2 - Rappel 24h avant (142 caractères) :
AI4CALL pour [Entreprise] : RAPPEL rdv demain [date] à [hh:mm]. Confirmez présence : [téléphone]
Template 3 - Code OTP (89 caractères) :
AI4CALL [Entreprise] : code de vérification [123456]. Valable 5 min. NE PAS partager
Template 4 - Notification urgente (125 caractères) :
AI4CALL pour [Entreprise] : [message urgent bref]. Contactez-nous : [téléphone] ou [email]
ÉVITEZ les emojis (réduisent la limite à 70 caractères !) :
❌ 😀❤️✅📅 → déclenchent l'encodage UCS-2, max 70 caractères par SMS
✅ utilisez du texte : "OK", "attention", "rappel" à la place
Attention aux lettres accentuées (OK mais coûteuses) :
⚠️ à è ì ò ù → supportées mais réduisent l'efficacité
✅ alternative si critique : "e" au lieu de "è"
ÉVITEZ les caractères spéciaux non-standard :
❌ symboles mathématiques ∑∏≠
❌ caractères cyrilliques/arabes/chinois (sauf si le destinataire les supporte)
✅ restez sur : lettres A-Z, chiffres 0-9, ponctuation de base
Instrisez l'assistant pour les workflows SMS
Configurez le prompt de l'assistant pour utiliser send_sms correctement avec fallback multi-canaux et optimisation des coûts.
"Le texte SMS DOIT être <160 caractères. Utilisez le template : 'AI4CALL pour [Entreprise] : rdv [jour] [date] à [hh:mm], [adresse courte]. Info : [tel]'. Abrégez intelligemment : 'rendez-vous'→'rdv', omettez les formalités inutiles. Comptez les caractères AVANT send_sms - si >160, raccourcissez davantage."
- Appelez l'assistant depuis votre mobile
- Simulez une réservation : nom, date, heure
- Demandez : "Envoyez-moi une confirmation SMS"
- Vérifiez : SMS reçu en moins de 30 secondes
- Contrôlez le tableau de bord : SMS disponibles décrémentés
- Vérifiez le texte : <160 caractères, expéditeur "AI4CALL", infos correctes
Test 2 - Fallback multi-canaux :
- Simulez un client sans WhatsApp (fournissez seulement numéro de mobile + email)
- L'assistant devrait tenter WhatsApp → échoue
- Fallback automatique vers Email
- Si Email échoue → SMS comme dernier recours
Test 3 - Gestion du crédit épuisé :
- Attendez SMS restants = 0 (ou simulez)
- Demandez l'envoi d'un SMS
- Vérifiez : l'assistant ne communique PAS d'erreur
- Vérifiez : fallback silencieux vers Email
- Le client reçoit la confirmation par Email sans problème
🛠️ Outil send_sms
Spécifications techniques de l'outil MCP pour l'envoi de SMS.
send_sms
Paramètres :
alias(string, défaut : "ai4call") : expéditeur SMS - FIXE "AI4CALL" actuellement, non personnalisabledst(obligatoire, string) : numéro de destination au format international (ex. "+393331234567")txt(obligatoire, string) : texte du message SMS - max 160 caractères recommandé
Exemple 1 - Confirmation de rendez-vous :
send_sms(
dst="+393331234567",
txt="AI4CALL pour Cabinet Rossi : rdv mar 15/3 à 10:00, Via Roma 1 MI. Annulation : 02-123456"
)
Exemple 2 - Code OTP :
send_sms(
dst="+393331234567",
txt="AI4CALL Cabinet Médical : code de vérification 847392. Valable 5 min. NE PAS partager"
)
Réponse attendue :
- ✅ Succès :
{"status": "sent", "message_id": "..."} - ❌ Erreur crédit :
{"error": "crédit SMS insuffisant"} - ❌ Erreur numéro :
{"error": "numéro de destination invalide"}
Notes importantes :
- ⚠️ Expéditeur TOUJOURS "AI4CALL" - paramètre alias ignoré actuellement
- ⚠️ Texte >160 caractères → multiples SMS facturés (2 SMS si 161-320 caractères, 3 SMS si 321-480 caractères)
- ⚠️ Caractères emoji réduisent la limite à ~70 caractères par SMS
- ⚠️ Chaque envoi décrémente le compteur de SMS disponibles
- ⚠️ Livraison typique : 2-30 secondes
❓ Questions fréquentes
Réponses aux questions les plus courantes sur l'intégration SMS
Système prépayé par packs : vous achetez du crédit SMS à l'avance, l'assistant consomme lorsqu'il envoie. Packs disponibles : Basique 100 SMS €5 (€0.05/SMS), Standard 500 SMS €20 (€0.04/SMS), Premium 1000 SMS €35 (€0.035/SMS). Le tableau de bord affiche les SMS restants en temps réel. Quand ils sont épuisés : l'outil send_sms échoue, l'assistant doit informer le client et utiliser une méthode alternative (email/WhatsApp). Rechargement : achetez un nouveau pack, le crédit s'additionne. Expiration : les SMS prépayés n'expirent JAMAIS.
Actuellement NON. L'alias de l'expéditeur est FIXE : "AI4CALL" pour tous les SMS envoyés via la plateforme. Le client reçoit un SMS avec l'expéditeur "AI4CALL", pas un nom d'entreprise personnalisé. Limitation technique de l'opérateur SMS. Futur : personnalisation d'alias custom possible (ex. "Cabinet Médical", "Agence XYZ") - contactez le support AI4CALL pour les mises à jour de la roadmap. Solution : incluez le nom de l'entreprise dans le TEXTE du SMS : "AI4CALL pour Cabinet Médical : rendez-vous confirmé..."
Limite standard : 160 caractères pour un seul SMS (encodage GSM-7). Si vous dépassez : le système divise automatiquement en multiples SMS concaténés (max 153 caractères chacun pour overhead). Exemples : 161 caractères = 2 SMS facturés, 320 caractères = 3 SMS. Les caractères spéciaux (emoji, accents) réduisent la limite à ~70 caractères par SMS (encodage UCS-2). Best practice : gardez sous 160 caractères, évitez les emoji pour maximiser l'efficacité des coûts. Comptez les caractères : AI4CALL affiche un aperçu de la longueur avant envoi.
Tableau de bord AI4CALL → Gestion du Plugin SMS montre : (1) SMS Disponibles : compteur en temps réel (ex. "90"), (2) Historique des Achats : tableau des dates d'achat, SMS achetés, prix payé, (3) bouton "ACTUALISER SMS RESTANTS" pour rafraîchir manuellement. Chaque appel de l'outil send_sms décrémente automatiquement le compteur. Pour des analytics détaillés : exportez les logs d'appels AI4CALL, filtrez par tool="send_sms", comptez les occurrences par période/client/campagne. Alertes automatiques : définissez une notification lorsque SMS <20 pour recharger à temps.
L'outil send_sms renvoie une erreur. Essayez de gérer cela gracieusement avec l'envoi de WhatsApp, email ou sauvegardez l'erreur et communiquez à l'utilisateur "recevra une confirmation sous peu".
Oui. Les SMS peuvent contenir des liens. Sur les téléphones plus anciens, le lien peut ne pas être cliquable, tandis que sur les smartphones modernes il l'est automatiquement. Dans tous les cas, il est recommandé d'utiliser des URL courtes (short link) pour économiser des caractères.
L'outil send_sms envoie IMMÉDIATEMENT - PAS de scheduling natif. Pour les envois programmés : (1) intégrez avec n8n/Zapier qui supporte les délais, (2) l'AI sauvegarde les données + timestamp souhaité sur la base de données, (3) un cron job lit la base de données, (4) lorsque le timestamp arrive : invoque send_sms automatiquement. Exemple de rappel de rendez-vous : (1) rendez-vous réservé le 15 mars, (2) sauvegarde événement + reminder_timestamp = 14 mars à 10:00, (3) un cron quotidien à 10h vérifie les rappels en attente, (4) envoie un SMS "Rappel : rendez-vous demain à 15h".
Pratiquement instantané. Latence typique : 2-30 secondes entre l'invocation de send_sms et la réception par le client. Facteurs de retard : (1) réseau de l'opérateur mobile du destinataire (zone de couverture), (2) téléphone allumé/éteint (si éteint : livraison à la rallumée), (3) roaming international (retards plus importants), (4) congestion du réseau (événements massifs, Nouvel An). Taux de livraison : 99% en moins de 60 secondes, 99.9% en moins de 5 minutes. Si le SMS n'arrive pas : vérifiez le numéro au format international correct (+39...), le client en zone de couverture, le téléphone non bloqué.
Par défaut NON. Contactez le support AI4CALL pour des informations sur les packs internationaux.
NON. Le système actuel est SEND-ONLY (envoi uniquement). Le client NE peut PAS répondre aux SMS reçus de "AI4CALL" - le numéro de l'expéditeur n'est pas bidirectionnel. Pour les conversations bidirectionnelles : utilisez WhatsApp (supporte les réponses natives) ou fournissez un numéro de téléphone d'entreprise dans le texte du SMS : "Pour répondre, appelez le 02-12345678". Futur : un numéro SMS bidirectionnel dédié avec webhook de réponses possible - contactez le support AI4CALL pour la roadmap. SMS idéal pour : notifications one-way, confirmations, alertes, rappels.
Encodage GSM-7 (standard) : supporte les lettres A-Z, chiffres 0-9, ponctuation de base (. , ! ? - ( ) ), symboles €£$@. Caractères NON supportés/problématiques : emoji (😀❤️ = erreur d'encodage ou fallback UCS-2 coûteux), lettres accentuées italiennes (à è ì ò ù = OK mais réduisent la limite 160→70 caractères), caractères cyrilliques/arabes/chinois (seulement si le destinataire les supporte). Best practice : utilisez uniquement l'ASCII standard, évitez les emoji, remplacez "è" par "e" si possible, testez avec un numéro réel avant la production.
Oui, SMS idéal pour OTP (One-Time Password). Workflow sécurisé : (1) générez un code aléatoire de 6 chiffres, (2) sauvegardez-le dans la base de données avec timestamp + user_id, (3) send_sms(text="Code de vérification : 123456. Valable 5 minutes"), (4) l'utilisateur insère le code dans l'app/web, (5) vérifiez la correspondance dans la base de données + non expiré. Best practice OTP : (1) code numérique de 6 chiffres (facile à saisir), (2) expiration 5-10 min, (3) rate limit des tentatives (max 3), (4) incluez le nom du service : "Code AI4CALL Cabinet Médical : 123456", (5) invalidation après utilisation.
Coût par SMS unique : €0.035-0.05 (dépend du pack acheté). Messages longs : si >160 caractères, divisé en multiples SMS facturés séparément. Exemple de calcul : message de 320 caractères = 3 SMS = €0.15 total (pack Premium €0.035×3). Optimisation des coûts : (1) gardez sous 160 caractères, (2) évitez les emoji (réduisent à 70 caractères), (3) utilisez des abréviations acceptables ("rendez-vous" → "rdv"), (4) considérez Email/WhatsApp pour les messages longs (gratuit illimité). ROI : comparez le coût SMS vs la valeur client/conversion.
Checklist de dépannage : (1) vérifiez la disponibilité de SMS-AI4CALL, (2) contrôlez le format du numéro : préfixe international +39 pour l'Italie, pas d'espaces/tirets, (3) texte SMS : <160 caractères, pas de caractères invalides, (4) Réponse Tool d'AI4CALL : cherchez les erreurs de l'outil send_sms (crédit insuffisant ou autre).