Aller au contenu
OmniChannels.ai

Assistants et agents IA

VS Code + OmniChannels.ai : des outils de messagerie en mode agent Copilot

Connexion via MCPConnexion via API et webhooksMis à jour le

En bref

VS Code se connecte à OmniChannels.ai en ajoutant notre serveur MCP distant, https://mcp.broadnet.me/mcp, au fichier .vscode/mcp.json comme serveur http. Une entrée promptString avec password demande votre jeton d'API et le stocke de façon sécurisée : aucune clé n'est versionnée. Le mode agent de GitHub Copilot peut alors envoyer des messages de test, lister les modèles WhatsApp et lire les rapports de livraison pendant qu'il vous aide à écrire le code d'intégration.

Ce que vous pouvez faire

  • Écrire du code conforme à vos modèles

    Copilot liste vos modèles WhatsApp approuvés via MCP et écrit une fonction d'envoi avec exactement les variables requises par chaque modèle.

    Exemple de demande

    “Liste mes modèles WhatsApp approuvés, puis écris une méthode C# qui envoie order_update avec le numéro de commande et la date de livraison.”

  • Créer et tester un point de terminaison webhook

    Copilot écrit un point de terminaison pour les statuts de livraison et les messages entrants, puis vous déclenchez un envoi de test pour voir arriver de vraies charges utiles.

    Exemple de demande

    “Écris un point de terminaison webhook FastAPI qui enregistre les statuts de livraison par identifiant de message et accepte les champs qui varient selon le canal, puis envoie un SMS de test au 447700900123 pour que je le voie arriver.”

  • Vérifier une livraison avant la mise en production

    Après l'envoi d'un message de test par votre code, Copilot lit le rapport de livraison pour que vous confirmiez le statut enregistré par votre gestionnaire.

    Exemple de demande

    “Vérifie le rapport de livraison du dernier message envoyé au 971500000000 et compare son statut avec celui enregistré dans notre base de données.”

  • S'appuyer sur la spécification, pas sur la mémoire

    Avec notre spécification OpenAPI dans l'espace de travail, Copilot utilise les chemins et champs exacts, y compris les envois qui nécessitent multipart/form-data.

    Exemple de demande

    “À partir de docs/omnichannels-openapi.yaml, écris une fonction utilitaire d'envoi WhatsApp en masse et indique quels champs sont envoyés en multipart/form-data.”

  • Rédiger des textes en arabe et en anglais

    Copilot rédige le texte du message dans les deux langues et vous le montre avant tout appel à un outil d'envoi.

    Exemple de demande

    “Rédige un SMS de rappel de rendez-vous en arabe et en anglais, d'un seul segment chacun, et montre-le-moi avant d'envoyer un test au 966500000000.”

Comment la connexion fonctionne

Connexion via MCPConnexion via API et webhooks

VS Code lit les serveurs MCP dans le fichier .vscode/mcp.json de votre espace de travail. Notre serveur est ajouté comme serveur http avec un en-tête Authorization, et le jeton provient d'une entrée de type promptString avec password à true : VS Code le demande une seule fois et le garde hors du fichier que vous versionnez.

En mode agent de GitHub Copilot, les outils des serveurs MCP activés apparaissent dans la liste des outils, où vous pouvez activer ou désactiver chacun d'eux, et VS Code peut vous demander de confirmer les appels d'outils. Gardez la confirmation activée pour tout ce qui envoie, car chaque envoi est un message réel et facturé. Les champs de configuration évoluent d'une version de VS Code à l'autre : consultez sa documentation MCP si un champ n'est pas reconnu.

  • Fichier : .vscode/mcp.json, serveur de type http, URL https://mcp.broadnet.me/mcp
  • En-tête : Authorization: Bearer ${input:omnichannels-token}
  • Saisie du jeton : promptString avec password: true
  • N'activez dans la liste des outils que ceux dont cet espace de travail a besoin

Mise en place

  1. 1

    Demander un accès à l'API

    Demandez un accès de test et recevez un jeton d'API. Les envois de test ne partent que vers vos propres numéros vérifiés.

  2. 2

    Obtenir une clé temporaire

    Dans le portail d'administration, ouvrez Integrations, puis MCP Integration, et choisissez Get temporary key.

    Guide: MCP server for AI agents
  3. 3

    Créer .vscode/mcp.json

    Ajoutez un serveur omnichannels de type http avec notre URL, un en-tête Authorization qui utilise ${input:omnichannels-token} et une entrée promptString avec password à true.

    Guide: MCP server for AI agents
  4. 4

    Démarrer le serveur et saisir la clé

    Démarrez le serveur depuis VS Code, collez votre clé lorsqu'elle est demandée et vérifiez que les outils apparaissent en mode agent Copilot.

  5. 5

    Limiter les outils

    Dans la liste des outils, désactivez ceux dont cet espace de travail n'a pas besoin et gardez la confirmation activée pour chaque outil d'envoi.

  6. 6

    Tester sur votre propre numéro

    Demandez à Copilot d'envoyer un message de test à votre numéro vérifié, puis lisez le rapport de livraison.

Documentation de l'éditeur

VS Code est une marque de son propriétaire. OmniChannels.ai n'est ni affilié à VS Code ni approuvé par lui ; cette page décrit une connexion réalisée avec les fonctions MCP, HTTP ou webhook propres à VS Code.

Exemple de flux

Le parcours d'une demande type, de VS Code jusqu'à votre client, puis retour.

  1. 01

    Mode agent Copilot

    Appelle les outils MCP pendant qu'il vous aide à coder

  2. 02

    Serveur MCP OmniChannels.ai

    Envoie, liste les modèles et lit les rapports avec votre jeton

  3. 03

    Votre téléphone de test

    WhatsApp ou SMS de test vers votre numéro vérifié

  4. 04

    Rapport de livraison

    Copilot relit le statut avec un outil de lecture

1. Mode agent Copilot: Appelle les outils MCP pendant qu'il vous aide à coder 2. Serveur MCP OmniChannels.ai: Envoie, liste les modèles et lit les rapports avec votre jeton 3. Votre téléphone de test: WhatsApp ou SMS de test vers votre numéro vérifié 4. Rapport de livraison: Copilot relit le statut avec un outil de lecture

Questions

Existe-t-il une extension OmniChannels.ai pour VS Code ?

Non. VS Code se connecte grâce à sa prise en charge standard des serveurs MCP dans .vscode/mcp.json, avec notre point de terminaison public et votre jeton d'API. Rien n'est à installer depuis la marketplace d'extensions.

Où mon jeton est-il stocké ?

Avec une entrée promptString réglée sur password: true, VS Code demande le jeton au démarrage du serveur et le stocke de façon sécurisée au lieu de l'écrire dans mcp.json. Versionnez le fichier, jamais la clé.

Quel mode de Copilot utilise les outils ?

Les outils MCP sont utilisés en mode agent de Copilot, où vous choisissez les outils disponibles. Consultez la documentation actuelle de VS Code pour votre version ainsi que les éventuelles stratégies de votre organisation qui encadrent MCP.

Puis-je reprendre la même configuration dans d'autres éditeurs ?

Tout client qui prend en charge Streamable HTTP et un en-tête Authorization personnalisé peut utiliser le même point de terminaison, même si chacun stocke la configuration dans son propre format. Consultez le guide du serveur MCP pour des exemples avec Cursor et Claude Code.

Obtenez un accès API et MCP

Indiquez vos canaux, pays et cas d'usage. Un ingénieur émet vos identifiants de test et vérifie vos numéros de test.