integrate-whatsapp

Vue d’ensemble de la skill integrate-whatsapp

Ce que fait integrate-whatsapp

La skill integrate-whatsapp vous aide à connecter WhatsApp à un produit avec Kapso, de l’onboarding client jusqu’à la livraison des messages. Elle est particulièrement utile si vous avez besoin d’un guide integrate-whatsapp qui couvre en un seul flux le setup link, la détection de connexion, les webhooks, l’envoi de templates, les médias et WhatsApp Flows.

Cas d’usage les plus adaptés

Utilisez cette integrate-whatsapp skill pour des systèmes backend qui doivent :

• onboarder des clients dans leur propre compte WhatsApp Business
• détecter quand un numéro devient connecté
• recevoir les événements de messages et de conversations via des webhooks
• envoyer des messages sortants, des templates et des médias
• gérer les endpoints Flows, le chiffrement et les étapes de publication

Pourquoi cette skill mérite d’être installée

Son principal atout, c’est la complétude du workflow. Le dépôt vous donne des parcours concrets pour une intégration à la fois orientée CLI et orientée API, ce qui compte si votre environnement évolue encore ou si vous devez prendre en charge plusieurs tenants. Si vous évaluez un integrate-whatsapp install, cette skill est plus solide qu’un prompt générique, parce qu’elle inclut les éléments qui bloquent souvent le passage en production : les IDs, le routage des webhooks, le cycle de vie du setup link et la distinction entre opérations au niveau projet et au niveau numéro de téléphone.

Comment utiliser la skill integrate-whatsapp

Installer et vérifier le contexte

Installez-la avec npx skills add gokapso/agent-skills --skill integrate-whatsapp. Avant de demander de l’aide pour l’implémentation, vérifiez le contexte du dépôt dans votre projet et lisez d’abord SKILL.md. Parcourez ensuite references/getting-started.md, references/platform-api-reference.md, references/webhooks-overview.md et references/setup-links.md, car ils décrivent mieux le vrai chemin d’intégration qu’un simple survol des assets.

Transformer un objectif vague en prompt exploitable

Pour un meilleur integrate-whatsapp usage, précisez :

• si vous utilisez Kapso CLI ou des appels API directs
• si l’application est multi-tenant ou liée à un seul numéro
• à quelle étape vous êtes bloqué : onboarding, détection de connexion, gestion des webhooks, envoi ou Flows
• les objets exacts dont vous disposez déjà, comme customer_id, phone_number_id, business_account_id ou le secret du webhook

Un bon prompt ressemble à ceci :

Implémentez l’onboarding WhatsApp pour un SaaS multi-tenant. J’ai déjà customer_id, j’ai besoin d’un flux de setup-link, de la confirmation webhook pour whatsapp.phone_number.created, et d’un chemin d’envoi de message utilisant phone_number_id.

Fichiers et workflows à lire en premier

Commencez par les fichiers qui structurent les choix d’implémentation :

• references/getting-started.md pour le flux de bout en bout
• references/detecting-whatsapp-connection.md pour les événements de connexion et la gestion des redirections
• references/webhooks-reference.md et references/webhooks-overview.md pour les règles de livraison des événements et la vérification de signature
• references/templates-reference.md si vous envoyez des templates ou des médias
• references/whatsapp-flows-spec.md ainsi que assets/sample-flow.json si vous avez besoin de Flows

Assets utiles à consulter tôt :

• assets/webhooks-example.json
• assets/dynamic-flow.json
• assets/send-template-order-status-update.json
• assets/send-interactive-buttons.json

Conseils pratiques d’utilisation

Privilégiez la CLI quand vous explorez l’état du projet, les clients ou les numéros, et utilisez des appels API bruts lorsque vous intégrez la solution dans votre propre backend. Ne confondez pas l’onboarding par setup link et l’envoi de messages : l’onboarding crée ou résout le numéro connecté, tandis que l’envoi nécessite le bon phone_number_id. Cette distinction est centrale pour une bonne integrate-whatsapp usage et permet d’éviter la plupart des erreurs d’intégration.

FAQ de la skill integrate-whatsapp

Est-ce réservé au Backend Development ?

Oui, cette skill integrate-whatsapp for Backend Development est principalement destinée au backend. Elle convient à l’onboarding côté serveur, au traitement des webhooks, à l’authentification API et à l’orchestration des messages. Ce n’est pas une skill pour la rédaction d’interfaces ni un simple modèle de prompt pour du contenu marketing.

En quoi est-ce différent d’un prompt classique ?

Un prompt classique décrit souvent l’intégration WhatsApp de manière vague. La integrate-whatsapp skill est plus utile parce qu’elle reflète la surface d’intégration réelle : setup links, événements webhook, résolution des numéros et WhatsApp Flows. Cela réduit les approximations quand vous avez besoin de quelque chose de déployable plutôt que d’illustratif.

Ai-je besoin de Kapso CLI pour l’utiliser ?

Non, mais la CLI est le chemin privilégié dans la skill, car elle aide à sélectionner le projet, à effectuer le setup et à découvrir les numéros. Si votre équipe ne peut pas utiliser d’outils CLI, les références prennent tout de même en charge les appels API directs via X-API-Key.

Quand ne faut-il pas utiliser integrate-whatsapp ?

Évitez cette skill si vous cherchez seulement une vue d’ensemble produit de WhatsApp, ou si vous vous intégrez à un fournisseur complètement différent et n’avez pas l’intention d’utiliser les API de la plateforme Kapso. Elle convient aussi mal si vous n’avez besoin que d’un exemple de message ponctuel, sans onboarding ni webhooks.

Comment améliorer la skill integrate-whatsapp

Donnez à la skill le bon état de départ

Les meilleures améliorations viennent d’un état d’intégration réel : l’ID du projet actuel, l’existence ou non d’un client, l’endpoint webhook que vous contrôlez et le type de message à envoyer. Cela rend les résultats de integrate-whatsapp install plus exploitables, parce que la skill peut raisonner sur le point de départ de votre flux au lieu de répéter la configuration depuis zéro.

Soyez explicite sur le mode d’échec

Pour obtenir de meilleurs résultats, nommez le blocage :

• « le setup link s’ouvre mais aucun numéro de téléphone n’est créé »
• « le webhook arrive mais la vérification de signature échoue »
• « l’envoi de template fonctionne en test mais pas en production »
• « je n’ai pas le bon phone_number_id »

Ce type d’information produit des conseils integrate-whatsapp usage bien plus utiles qu’une demande de plan d’intégration générique.

Utilisez les bons artefacts pour itérer

Si votre première réponse est incomplète, faites itérer avec l’un de ces éléments :

• le payload webhook que vous avez reçu
• le JSON du template que vous voulez envoyer
• le JSON de Flow que vous voulez publier
• la sortie de kapso status, kapso whatsapp numbers list ou la réponse de votre API

Pour le travail de integrate-whatsapp guide, ces artefacts comptent plus que des exigences générales, car ils permettent de corriger rapidement les IDs, les noms d’événements, la gestion des redirections et la forme du payload.

Surveillez les erreurs de production les plus courantes

Les échecs les plus fréquents viennent d’un mauvais identifiant, d’un mauvais type de webhook souscrit ou de l’idée erronée que la fin du setup signifie automatiquement que l’envoi de messages est prêt. Améliorez la sortie de la skill en précisant si vous avez besoin de webhooks projet ou de webhooks numéro de téléphone, si vous utilisez Kapso ou des endpoints proxy Meta, et si votre application doit prendre en charge un mode coexistence ou un mode dédié.