Mails et WhatsApp en
une seule requête.
Un seul appel à POST /message envoie le même message à votre client sur WhatsApp et par mail. Il part de votre propre numéro WhatsApp et de votre propre boîte mail, sans surcoût : le canal email et l'envoi multicanal sont inclus dans toutes les offres, y compris la Free.
Le principe
Deux canaux, une requête, votre propre infrastructure
Certains messages méritent d'arriver deux fois : une commande prête à être retirée, un rappel de rendez-vous, une facture en retard. Votre client lit peut-être WhatsApp en premier, ou ne consulte ses mails qu'au bureau.
D'habitude, cela veut dire deux intégrations : un fournisseur WhatsApp d'un côté, un service d'emailing de l'autre, deux SDK, deux factures et deux journaux à recouper. Avec UnlimitedMessaging, les deux canaux passent par le même endpoint. Vous listez les canaux voulus dans un tableau channels, vous indiquez le téléphone et l'adresse du destinataire dans to, et l'API s'occupe du reste.
Rien ne part d'un expéditeur partagé. Les messages WhatsApp partent de votre propre numéro, lié en scannant un QR code. Les mails partent de votre propre adresse, via votre propre serveur mail, et une copie arrive dans votre dossier Envoyés. UnlimitedMessaging n'est que le transport : votre délivrabilité et votre réputation restent les vôtres.
Et c'est gratuit pour commencer. Le canal email et l'envoi multicanal sont disponibles sur toutes les offres, y compris l'offre Free, sans carte bancaire.
La requête
À quoi ressemble la requête
Un seul corps JSON avec un objet to et un tableau channels. Authentifiez-vous avec votre clé API en Bearer token.
{
"to": {
"phone": "+33612345678",
"email": "[email protected]"
},
"subject": "Votre commande est prête",
"text": "Bonjour, votre commande est prête à être retirée.",
"channels": [
{
"channel": "WHATSAPP"
},
{
"channel": "EMAIL"
}
]
}curl -X POST https://api.unlimitedmessaging.app/message \
-H "Authorization: Bearer $UM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": {
"phone": "+33612345678",
"email": "[email protected]"
},
"subject": "Votre commande est prête",
"text": "Bonjour, votre commande est prête à être retirée.",
"channels": [
{
"channel": "WHATSAPP"
},
{
"channel": "EMAIL"
}
]
}'to
Qui reçoit le message : phone pour WhatsApp, email pour le mail. Donnez les deux pour toucher le même client sur les deux canaux.
channels
Les canaux d'envoi, par exemple WHATSAPP et EMAIL. Chaque entrée peut surcharger text, html et subject pour ce canal uniquement.
subject, text, html
Le contenu commun. Le sujet sert au mail, qui accepte aussi un corps HTML. WhatsApp utilise le texte.
accountId (facultatif)
Le compte connecté qui envoie. Sans lui, votre seul compte actif sur ce canal est utilisé : votre numéro WhatsApp, votre boîte mail.
Authorization: Bearer
Votre clé API, envoyée en Bearer token à https://api.unlimitedmessaging.app.
Ce qui se passe ensuite
Un message par canal, regroupés par un dispatchId
L'API ne fond pas les canaux dans un traitement opaque. Chaque canal devient un vrai message, que vous suivez séparément.
- 1
Vous envoyez une requête
Un seul POST /message avec to et channels. Pas de boucle de votre côté, pas de second appel pour l'autre canal.
- 2
Un message est créé par canal
L'API crée un message WhatsApp et un message email, marqués du même dispatchId pour les retrouver ensemble.
- 3
Chacun part de votre compte, avec son propre statut
Le message WhatsApp part de votre numéro, le mail de votre boîte mail. Chaque message garde son propre statut : vous savez exactement comment s'est passé chaque canal.
- Requête API pour WhatsApp et le mail ensemble
- 1Requête API pour WhatsApp et le mail ensemble
- Pièces jointes maximum par mail
- 20Pièces jointes maximum par mail
- Taille totale des pièces jointes par mail
- 25 MoTaille totale des pièces jointes par mail
- Offre Free, email et multicanal inclus
- 0 EUROffre Free, email et multicanal inclus
Contenu par canal
Adaptez le message à chaque canal
Un mail et un WhatsApp ne se lisent pas de la même façon. Gardez un contenu commun et ne surchargez que ce qui change, dans l'entrée du canal concerné.
{
"to": {
"phone": "+33612345678",
"email": "[email protected]"
},
"subject": "Votre commande n°1042 est prête",
"html": "<p>Bonjour,</p><p>Votre commande <strong>n°1042</strong> est prête à être retirée en boutique.</p>",
"channels": [
{
"channel": "WHATSAPP",
"text": "Bonjour, votre commande n°1042 est prête à être retirée."
},
{
"channel": "EMAIL"
}
]
}Canal par canal
Ce qui change entre WhatsApp et le mail
Même requête, mais chaque canal garde ses propres règles.
| WhatsAppVotre propre numéro | EmailVotre propre boîte mail | |
|---|---|---|
| Expéditeur | Votre numéro WhatsApp, lié en scannant un QR code | Votre adresse mail, via votre propre serveur mail |
| Destinataire | to.phone | to.email |
| Sujet | Non utilisé | Obligatoire |
| Corps | text, ou le HTML converti en texte brut | text et/ou HTML |
| Pièces jointes | 1 fichier par message | Jusqu'à 20 fichiers, 25 Mo au total |
| Réponses reçues | Arrivent sur votre numéro WhatsApp | Arrivent dans la boîte de réception du tableau de bord, regroupées par fil |
Un seul canal
La forme mono-canal fonctionne toujours
Tous vos clients ne vous donnent pas à la fois un numéro et une adresse mail. Pour un seul canal, laissez de côté to et channels et utilisez recipient : un numéro de téléphone envoie sur WhatsApp, une adresse mail envoie par mail. Un mail a besoin d'un subject.
Comme pour la forme multicanal, accountId est facultatif : sans lui, votre seul compte actif sur ce canal est utilisé.
{
"recipient": "[email protected]",
"subject": "Votre facture",
"text": "Bonjour, votre facture du mois est disponible."
}Votre numéro, votre boîte mail, gratuit
Votre propre infrastructure, sans surcoût
Vous apportez les expéditeurs que vos clients connaissent déjà. Nous transportons les messages.
Votre propre numéro WhatsApp
Liez le numéro que vos clients ont déjà enregistré en scannant un QR code. Messages illimités à prix mensuel fixe, et une offre Free sans carte bancaire.
API, SDK, tableau de bord et MCP
Appelez l'API directement ou via les SDK TypeScript et Python, rédigez par canal dans le tableau de bord, ou laissez Claude ou ChatGPT envoyer via l'outil send-message du serveur MCP.
Votre propre boîte mail
Connectez-la en IMAP/SMTP : Gmail avec un mot de passe d'application Google, votre propre domaine, ou n'importe quel fournisseur IMAP/SMTP. Les réglages serveur sont détectés à partir de l'adresse.
Gratuit sur toutes les offres
Le canal email et l'envoi multicanal sont inclus dans toutes les offres, l'offre Free comprise.
FAQ
Questions sur l'envoi de mails et de WhatsApp en une requête
Sources
Sources & références
Pour vérifier par vous-même les informations de cet article :
Écrit par
Ilian · Senior Software Engineer
Ingénieur logiciel senior, il fonde et dirige plusieurs sociétés tech. Il conçoit des produits autour des API de messagerie, de l’automatisation et de l’intégration de l’IA, et partage ici ce qu’il apprend en construisant.
Touchez vos clients sur WhatsApp et par mail, en un seul appel.
Liez votre numéro WhatsApp, connectez votre boîte mail et envoyez votre premier message multicanal avec l'offre Free. Sans carte bancaire.
Commencer gratuitement