Skip to main content
POST
API Famulor 1.0 (héritée). Cette page concerne uniquement Famulor 1.0 (app.famulor.de) et est conservée pour la compatibilité. Pour la plateforme actuelle, consultez la référence API Famulor 2.0.
Envoie un message WhatsApp à l’aide d’un modèle Meta préapprouvé via votre expéditeur WhatsApp Famulor. Les messages modèles sont requis pour initier une conversation avec un utilisateur pour la première fois ou pour envoyer un message en dehors de la fenêtre de messagerie de 24 heures.
Ce point de terminaison est limité à 5 requêtes par seconde par utilisateur.

Corps de la requête

integer
requis
L’ID de l’expéditeur WhatsApp depuis lequel envoyer (obtenu via le point de terminaison Récupérer les expéditeurs)
integer
requis
L’ID du modèle de message à utiliser (obtenu via le point de terminaison Récupérer les modèles)
string
requis
Le numéro de téléphone du destinataire au format international (par ex. +1234567890)
string
Le nom du destinataire, 255 caractères maximum (utilisé pour le suivi des conversations et à des fins de CRM)
object
Paires clé-valeur pour les variables du modèle. Les clés doivent correspondre aux noms de variables du modèle. Si le modèle comporte les variables {{1}}, {{2}}, etc., fournissez-les sous la forme {"1": "value1", "2": "value2"} ou en utilisant les clés nommées du tableau variables du modèle.

Champs de réponse

boolean
Indique si le message a été envoyé avec succès
integer
L’ID de la conversation (nouvelle ou existante) associée à ce message
integer
L’ID de l’enregistrement du message de conversation
integer
L’ID de l’enregistrement du message WhatsApp
string
Le SID de message Twilio pour le suivi de la livraison
string
Le statut de livraison initial du message (par ex. queued, sent)

Réponses d’erreur

Remarques

  • Les messages modèles doivent utiliser des modèles approuvés. Les modèles au statut pending ou rejected échoueront.
  • L’expéditeur doit être online. Les expéditeurs hors ligne ne peuvent pas envoyer de messages.
  • Le coût des messages est automatiquement déduit du solde de votre compte Famulor (crédits pour les utilisateurs tenant, minutes pour les utilisateurs directs).
  • Après l’envoi d’un message modèle, une fenêtre de messagerie de 24 heures s’ouvre. Pendant cette fenêtre, vous pouvez envoyer des messages libres sans avoir besoin d’un modèle.
  • Si une conversation existe déjà avec le destinataire, le message est ajouté à la conversation existante.
  • Limite de débit : 5 requêtes par seconde par utilisateur.