# Démarrage rapide

URL: https://wa.genuka.com/docs/quickstart
Language: French

> Du compte au premier message envoyé, en une dizaine de minutes.

1. ### 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 7 jours : un numéro WhatsApp, son quota de messages, l'API REST
   et les webhooks inclus. Aucune carte bancaire n'est demandée.

2. ### 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.

   > [!NOTE]
   > **Vous utilisez déjà l'application WhatsApp Business ?**
   >
   > Vous pouvez garder l'application sur votre téléphone tout en branchant l'API sur le même
   > numéro : c'est le mode **coexistence**. Vos conversations restent synchronisées dans les deux
   > sens. Seule différence à connaître : le débit d'envoi est plafonné à 20 messages par seconde.

3. ### 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.

4. ### 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](https://wa.genuka.com/docs/api#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 :

   ```bash
   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 :

   ```bash
   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 👋"
     }'
   ```

   > [!WARNING]
   > Ce premier envoi ne fonctionne que si le destinataire vous a écrit dans les dernières
   > **24 heures**. Sinon, il faut passer par un template approuvé — voir
   > [Envoyer des messages](https://wa.genuka.com/docs/messages).

5. ### 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](https://wa.genuka.com/docs/webhooks).

## Et ensuite

* [Authentification](https://wa.genuka.com/docs/authentication) — clés API, portée, rotation.
* [Envoyer des messages](https://wa.genuka.com/docs/messages) — tous les types disponibles et la règle des 24 h.
* [Webhooks](https://wa.genuka.com/docs/webhooks) — événements, signature, rejeu.
