Passer au contenu
Documentation développeur Support Demander une démo Se connecter
Pushwoosh.com

Serveur MCP de messagerie ManyMoney

Aperçu

Anchor link to

Le serveur MCP de messagerie ManyMoney est le pendant d’envoi du serveur MCP IA de ManyMoney. Là où le serveur MCP IA de ManyMoney vous aide à planifier et à construire des campagnes, le serveur MCP de messagerie donne à votre agent IA le pouvoir de livrer réellement des messages — notifications push, e-mails, SMS, WhatsApp, Telegram, LINE, Kakao, et plus encore — à la demande, à partir d’instructions en langage naturel.

Connectez-le à n’importe quel client Model Context Protocol (MCP) et votre agent peut envoyer un push à un segment ou un e-mail personnalisé à un utilisateur spécifique, le tout à partir d’une seule requête en langage naturel.

Canaux pris en charge

Anchor link to
CanalTypes de messages
Push — iOSNotifications standard, silencieuses et critiques, pushes VoIP et Live Activities
Push — AndroidPushes standard, plus Huawei, Baidu et Amazon Fire
Push — WebPush web dans Chrome, Firefox, Safari et Edge (Windows)
E-mailCorps HTML, modèles, pièces jointes, expéditeur/répondre-à personnalisés
SMSMessages texte via la plateforme SMS configurée sur votre compte
WhatsAppModèles approuvés par Meta pour les envois sortants ; texte libre uniquement dans la fenêtre de 24 heures après qu’un utilisateur vous a contacté en premier
TelegramMessages texte avec des variables de contenu
LINEMessages de contenu et modèles
KakaoMessages de contenu et modèles

Comment ça marche

Anchor link to
  1. Connectez le serveur MCP de messagerie à votre client IA une seule fois (voir Connecter le serveur MCP ci-dessous).
  2. Dans votre client IA, ouvrez une nouvelle discussion et décrivez l’envoi en langage clair. Incluez l’application, l’audience (segment ou utilisateurs spécifiques), le texte du message, et quand l’envoyer si ce n’est pas immédiat. Voir ce qu’il faut inclure dans votre demande ci-dessous. Vous n’avez pas besoin de construire vous-même des requêtes API ou du JSON.
  3. Lorsque l’agent est prêt à envoyer, examinez les détails et approuvez l’action dans votre client.
  4. Après votre approbation, Pushwoosh envoie le message et renvoie un code de message. Utilisez-le dans l’Historique des messages pour retrouver l’envoi et suivre la livraison et les statistiques.

Ce que votre agent peut faire

Anchor link to

Après la configuration, l’agent peut :

  • Envoyer sur n’importe quel canal pris en charge : push (iOS, Android, Web), e-mail, SMS, WhatsApp, Telegram, LINE ou Kakao.
  • Atteindre un segment : diffuser à tout le monde dans un segment.
  • Atteindre des utilisateurs spécifiques : envoyer à un ou plusieurs ID utilisateur après un événement (mise à jour de commande, réinitialisation de mot de passe, etc.).
  • Planifier la livraison : envoyer maintenant, à une heure définie, après un délai, ou dans le fuseau horaire local de chaque utilisateur.
  • Personnaliser le contenu : remplir les espaces réservés des modèles tels que {{first_name}} ou {{promo_code}} par destinataire.
  • Compter les envois pour une campagne : indiquer à l’agent quel code de campagne utiliser. La livraison et l’engagement pour cet envoi apparaissent sous cette campagne dans le Panneau de Contrôle.

Voir les exemples de requêtes de discussion dans Envoyer des messages depuis votre client IA ci-dessous.

Clients IA compatibles

Anchor link to

Le serveur MCP de messagerie fonctionne avec n’importe quel client compatible MCP, y compris :

  • Claude Desktop par Anthropic
  • Cursor et Windsurf
  • Cline et Continue
  • Agents personnalisés construits sur la spécification MCP

Connecter le serveur MCP

Anchor link to

Étape 1. Assurez-vous d’avoir un compte Pushwoosh et un jeton d’API

Anchor link to

Le serveur MCP de messagerie s’authentifie avec un jeton d’API de serveur Pushwoosh.

Dans le Panneau de Contrôle Pushwoosh, allez dans Paramètres → Accès API, cliquez sur Générer un nouveau jeton, sélectionnez Serveur, et enregistrez le jeton. Vous l’ajouterez à la configuration du client à l’étape suivante.

Le jeton hérite des permissions de votre compte. Limitez-le aux applications par lesquelles vous voulez que l’agent envoie.

Étape 2. Ajouter le serveur à votre client IA

Anchor link to

Utilisez le point de terminaison suivant :

https://messaging-api.svc-nue.pushwoosh.com/mcp

Ajoutez le serveur à votre fichier de configuration Claude Desktop (claude_desktop_config.json) :

{
  "mcpServers": {
    "pushwoosh-messaging": {
      "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp",
      "headers": {
        "Authorization": "Token YOUR_API_TOKEN"
      }
    }
  }
}

Redémarrez Claude Desktop après avoir sauvegardé.

Étape 3. Essayez-le

Anchor link to

Ouvrez une nouvelle discussion dans votre client IA et demandez quelque chose de concret :

“Dans l’application XXXXX-XXXXX, envoyez un push à mes appareils de test avec le titre ‘Bonjour de la part de l’agent’ et le corps ‘Ceci est un message de test.’”

Avant d’approuver l’action de l’agent, confirmez l’audience et le contenu du message.

Si la connexion fonctionne, l’agent envoie le message et renvoie un code de message Pushwoosh tel que PW-12345-67890.

Envoyer des messages depuis votre client IA

Anchor link to

L’agent envoie un message par requête.

Ce qu’il faut inclure dans votre demande

Anchor link to

Décrivez les détails ci-dessous dans votre discussion pour que l’agent sache quoi envoyer, qui doit le recevoir et quand. Utilisez un langage simple (par exemple, “application XXXXX-XXXXX”, “segment abandon-panier”).

Ce qu’il faut inclureDescription
applicationCode d’application (XXXXX-XXXXX)
platformsID de canal à utiliser pour l’envoi (push, e-mail, SMS, etc.)
targetCode de segment, expression de segment, ou une liste explicite d’utilisateur, hwid, ou jeton push (ciblage transactionnel)
message_payloadPush : titre et corps, ou un préréglage de push, avec son, badge et action d’ouverture optionnels

E-mail : sujet, corps ou modèle, pièces jointes

SMS et messageries : texte ou modèle approuvé
scheduleEnvoyer à une heure spécifique, après un délai, ou suivre les fuseaux horaires des utilisateurs
dynamic_content_placeholdersValeurs pour les espaces réservés tels que {{first_name}} ou {{promo_code}}
campaignCode de campagne auquel attribuer le message
frequency_cappingLe plafonnement de la fréquence limite la fréquence à laquelle chaque utilisateur reçoit un message dans une fenêtre de temps

Comment l’agent envoie un message

Anchor link to

L’agent utilise l’outil Notify pour créer et envoyer un message. Il prend en charge deux modes de ciblage :

ModeQuand l’utiliser
SegmentDiffusion à tous les utilisateurs correspondant à un segment ou une expression de segment. Prend en charge la programmation, le plafonnement de la fréquence, le taux d’envoi, et les groupes de contrôle.
TransactionnelEnvoi à une liste spécifique d’utilisateurs, de hwids, ou de jetons push. Idéal pour les messages déclenchés ou personnalisés.

Exemples de prompts

Anchor link to

Push vers un segment :

Dans l’application XXXXX-XXXXX, envoyez un push au segment abandon-panier sur iOS et Android.

Titre : “Vous hésitez encore ?” Corps : “Votre panier vous attend, voici 10% de réduction.”

Programmez pour 15h dans le fuseau horaire local de chaque utilisateur. Utilisez le code de campagne promo-printemps.

E-mail à un utilisateur :

Dans l’application XXXXX-XXXXX, envoyez un e-mail à l’utilisateur uid-123 en utilisant le modèle d’e-mail flux-bienvenue-v2 avec l’espace réservé {{first_name}} défini sur Alex.

SMS à un segment :

Dans l’application XXXXX-XXXXX, envoyez un SMS au segment utilisateurs-vip avec le corps “Votre offre exclusive se termine ce soir.” Envoyez maintenant.

Telegram à un segment :

Dans l’application XXXXX-XXXXX, envoyez un message Telegram au segment abonnes-mensuels avec le corps “Bonjour {{first_name}}, votre facture de mai est prête — téléchargez-la depuis votre compte.” Programmez-le pour demain à 10h00 UTC.

Authentification

Anchor link to

Le serveur MCP de messagerie prend en charge deux méthodes d’authentification :

MéthodeComment l’utiliser
Jeton d’APIAjoutez Authorization: Token VOTRE_JETON_API à chaque requête. Recommandé pour les agents et les pipelines automatisés.
Jeton de session (SSO)Ajoutez Authorization: Bearer VOTRE_JETON_SSO. Pour les intégrations programmatiques qui utilisent le SSO OAuth2 de Pushwoosh pour agir dans le cadre d’une session utilisateur spécifique. Non nécessaire pour les configurations d’agent typiques — utilisez plutôt un jeton d’API de serveur.

Les requêtes avec un jeton manquant ou invalide sont rejetées avec un code HTTP 401.

Conseils et meilleures pratiques

Anchor link to
  • Examinez toujours attentivement chaque envoi avant de l’approuver. Ce sont des livraisons réelles, et elles partent lorsque vous approuvez ou à l’heure programmée. Assurez-vous que l’application, l’audience, le canal et le texte du message dans le client correspondent à ce que vous aviez prévu.
  • Utilisez un jeton d’API de serveur dédié pour l’agent. Créez un jeton d’API de serveur distinct dans Paramètres → Accès API et limitez-le aux applications à partir desquelles l’agent doit envoyer. De cette façon, l’accès de l’agent reste limité à ces seules applications.
  • Utilisez le ciblage transactionnel pour les messages déclenchés. Lorsque vous envoyez à un ID utilisateur connu après un événement (commande expédiée, réinitialisation de mot de passe), utilisez le mode transactional avec users: [userId]. Ne construisez pas un segment d’une seule personne pour le même envoi. Voir NotifyTransactional.
  • Testez sur des appareils de test avant un envoi important. Avant d’envoyer à un segment réel, demandez à l’agent d’envoyer d’abord à vos appareils de test enregistrés. Par exemple : “Dans l’application XXXXX-XXXXX, envoyez un push à mes appareils de test avec le titre ‘Test’ et le corps ‘Vérifier le texte ici.’” Cela achemine le message uniquement vers les appareils que vous avez ajoutés dans Paramètres → Appareils de test. Lorsque l’aperçu semble correct, demandez le segment ou l’audience réel.
  • Nommez une campagne dans votre requête. Incluez un code de campagne dans la discussion (par exemple, promo-printemps) afin que les résultats apparaissent sous la bonne campagne dans le Panneau de Contrôle Pushwoosh.
  • Confirmez avant de diffuser. Configurez votre client IA pour demander une confirmation explicite avant d’approuver tout appel d’outil qui cible un segment. Une diffusion à une large audience est irréversible.
  • Utilisez des espaces réservés pour la personnalisation. Transmettez les valeurs pour les espaces réservés comme {{first_name}} ou {{promo_code}} dans votre requête de discussion plutôt que de construire des messages séparés pour chaque utilisateur.

Sujets connexes

Anchor link to
Serveur MCP IA de ManyMoney : planifier et construire des campagnes
IA de ManyMoney dans le Panneau de Contrôle
Aperçu des outils d'IA