Démarrage rapide

Créez votre compte

Inscrivez-vous avec le nom de votre entreprise, un email et un mot de passe. Votre espace s'ouvre sur un essai gratuit de 14 jours : un numéro WhatsApp, son quota de messages, l'API REST et les webhooks inclus. Aucune carte bancaire n'est demandée.

Connectez votre numéro WhatsApp

Depuis votre tableau de bord, ouvrez Connexions. Vous y trouvez une URL unique. Ouvrez-la pour connecter votre propre numéro via l'Embedded Signup de Meta — ou transmettez-la à une entreprise dont vous gérez les numéros.

Le compte, ses numéros et ses templates apparaissent ensuite automatiquement dans votre espace.

Créez une clé API

Toujours dans le tableau de bord, section Paramètres > API Keys, générez une clé. Elle s'affiche une seule fois — copiez-la immédiatement.

Envoyez votre premier message

Pour envoyer un message en utilisant l'API officielle de Whatsapp, il y a 2 voies :

• Message libre : Pour envoyer un message libre comme dans l'exemple qui sera donnée ci-dessous, votre correspondant doit vous avoir écrit en premier. Donc pour le test, demandez à votre correspondant de vous envoyer un message à votre numéro. En faisant cela, vous ouvrez ce que Meta appelle la fenetre de service de 24 heures. Cette fenêtre de service vous permet d'envoyer n'importe quel type de message à vos correspondants et ceci entièrement gratuitement

• Templates/Modèles : Pour envoyer un template, il faudra l'avoir créé au préalable. Vous pouvez le faire via l'API, confère la section sur les templates. Vous pouvez également le faire directement via l'interface : Aller à Clients / Numéros de téléphone > Voir > Templates (vous pouvez donc créer un template directement). Les templates sur les numéros nouvellement connectés à Whatsapp Cloud API peuvent mettre jusqu'à 24 heures pour être validés. PS : Ce processus de validation permet aux équipes de Meta de garder un ecosystème sûr et fiables (afin d'éviter des SPAMs ou autres contenus dangeureux / illégal).

La suite de cette section considèrera que vous avez déjà reçu un message sur votre numéro à partir de celui de votre correspondant.

La prochaine étape c'est de récupérer l'identifiant de la connexion à utiliser. Pour ça vous avez 2 pistes. Soit utiliser l'API :

curl https://wa.genuka.com/api/v1/connections \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY"

Soit aller dans Clients / Numéros et vous allez dans les détails du numéros, vous verrez le connectionId.

Puis envoyez :

curl https://wa.genuka.com/api/v1/messages \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "cnx_...",
    "to": "+237699001122",
    "text": "Bonjour depuis Genuka WA 👋"
  }'

Recevez les réponses

Dans le portail, section Webhooks, déclarez l'URL de votre application et choisissez les événements à recevoir. Le secret de signature s'affiche une seule fois — copiez-le.

Chaque livraison est signée ; votre endpoint doit vérifier cette signature avant de traiter quoi que ce soit. Voir Webhooks.