Connecter un numéro

Les numéros arrivent par l'Embedded Signup de Meta — aucun identifiant ne passe par nous, ni par vous.

Le lien de connexion

Chaque compte dispose d'un lien public unique à l'adresse /connect/{votre-slug}. Ouvrez-le vous-même pour connecter votre propre numéro, ou partagez-le — par e-mail, messagerie ou via un bouton sur votre site — avec une entreprise dont vous gérez les numéros. Il affiche le nom de votre marque et un bouton Connecter WhatsApp.

Ce qui se passe pendant la connexion

La personne qui se connecte s'authentifie avec Facebook et sélectionne (ou crée) le compte WhatsApp Business et le numéro à utiliser.

L'autorisation est échangée

À la fin du processus, la plateforme échange un code à usage unique contre un jeton d'accès longue durée, qui est stocké chiffré. Le jeton ne quitte jamais le serveur.

Le numéro apparaît dans votre tableau de bord

Une Company (nommée d'après l'entreprise renvoyée par Meta) et sa Connection — le WABA et le numéro de téléphone — sont créées sous votre compte. Le WABA est abonné aux webhooks pour que les statuts remontent, et le numéro est enregistré sur la Cloud API afin de pouvoir envoyer immédiatement.

Numéros déjà sur l'application WhatsApp Business

Un numéro en coexistence reste sur l'application WhatsApp Business et est enregistré par Meta lui-même : nous ne touchons donc pas à son enregistrement — il se connecte et envoie exactement de la même façon. Si un enregistrement échoue malgré tout (un code PIN en deux étapes déjà défini, par exemple), la connexion est tout de même enregistrée, et le numéro devient utilisable une fois enregistré côté Meta.

Ce que vous voyez ensuite

Pour chaque entreprise connectée : le WABA, son ou ses numéros avec leur note de qualité et leur statut, chaque template avec son état d'approbation, et les statistiques de livraison des messages (envoyés / livrés / lus / échoués avec motifs).

Savoir QUI vient de connecter QUEL numéro

Si vous partagez votre lien avec plusieurs clients, ajoutez-y votre propre identifiant pour ce client :

https://wa.genuka.com/connect/{votre-slug}?ref=cli_8f3a91e4

Cette référence est posée sur la Company créée à la fin du parcours, et vous la retrouvez ensuite :

GET /api/v1/connections?externalRef=cli_8f3a91e4

curl "https://wa.genuka.com/api/v1/connections?externalRef=cli_8f3a91e4" \
  -H "Authorization: Bearer pk_live_xxx"

{ "data": [ { "id": "con_1", "companyId": "cmp_123", "companyName": "Acme Coffee",
              "displayPhoneNumber": "+237 6 90 …", "externalRef": "cli_8f3a91e4",
              "qualityRating": "GREEN", "status": "connected" } ] }

Une seule ligne : celle de ce client. C'est ce qui vous évite les deux mauvaises réponses à cette question — prendre la connexion la plus récente, qui finit par attribuer le numéro d'un client à un autre le jour où deux se connectent à la même minute ; ou afficher la liste et demander à votre client de désigner le sien, ce qui lui montre au passage les numéros et raisons sociales de tous vos autres clients.

Choisissez une référence imprévisible

Elle voyage dans une URL. Un identifiant séquentiel (client-42) se devine, et qui le devine peut rattacher son propre numéro à ce client. Utilisez un UUID ou un aléa équivalent.

Caractères acceptés : lettres, chiffres, . _ : -, 128 au maximum. Une référence absente ou malformée n'est jamais ignorée au profit de la liste complète : la recherche renvoie simplement zéro ligne. Renvoyer la même référence lors d'une reconnexion la déplace vers le numéro qui vient d'être connecté — c'est votre registre, pas le nôtre.

Numéros multiples, limites et reconnexion

Vous pouvez connecter autant de numéros que votre abonnement en paie, répartis sur autant d'entreprises que vous le souhaitez. Un nouveau numéro occupe une place libre ; dépasser le nombre de numéros payés est refusé avec 402 plan_limit_numbers, et l'augmenter demande un nouveau paiement depuis la page Facturation. Relancer le flux de connexion pour un numéro déjà connecté rafraîchit son jeton et ses informations plutôt que de créer un doublon — et ne consomme jamais de place.