Obtenir l’accès partenaire
Le scopePARTNER est accordé manuellement aux revendeurs approuvés, et il ne peut pas être auto-émis. Pour devenir revendeur et recevoir une clé avec le scope PARTNER, consultez le Programme Partenaire ou écrivez à [email protected].
Seuls les partenaires Licence à prix réduit (revendeurs) peuvent créer des comptes, en obtenir le prix et les désactiver. Tout autre partenaire reçoit PARTNER_CONTRACT_CANNOT_PROVISION (ou PARTNER_CANNOT_DEACTIVATE à la désactivation). Un compte qui n’est pas un partenaire activé reçoit PARTNER_ACCESS_REQUIRED.
Facturation
Chaque compte que vous créez a son propre abonnement au plan Business, facturé sur votre moyen de paiement selon la périodicité choisie (MONTHLY ou YEARLY). Allo débite la période complète à la création du compte, avec votre remise partenaire appliquée. Il n’y a pas de prorata. Allo ne facture jamais votre client : vous facturez vos clients vous-même.
Appelez Obtenir le prix d’un compte pour connaître le coût d’un nouveau compte avant de le créer.
Comment fournir une eSIM à un compte
Une eSIM installe le numéro Allo du compte dans le téléphone de votre client, comme une deuxième SIM. Les appels arrivent sur le téléphone par le réseau mobile français. Les eSIM sont disponibles en France uniquement, sur des numéros créés pour elles.1
Créez le compte avec un numéro eSIM
Appelez Créer un compte avec
number_preference: {"country": "FR", "esim": true}. Ajoutez un prefix, par exemple "7", pour choisir le début du numéro. Le compte reçoit un numéro mobile français qui peut porter une eSIM.2
Obtenez l'offre
Appelez Obtenir l’offre eSIM pour connaître les frais de mise en service et les paliers de données. Les prix suivent l’abonnement que vous payez pour ce compte : sa devise, sa périodicité de facturation et votre remise partenaire.
3
Commandez l'eSIM
Appelez Commander une eSIM avec le numéro, un palier et l’identité de l’entreprise à laquelle la ligne est enregistrée. Allo débite votre moyen de paiement enregistré et renvoie l’eSIM avec le statut
PROVISIONING. Envoyez un en-tête Idempotency-Key pour qu’une nouvelle tentative ne vous débite jamais deux fois.4
Attendez que l'eSIM soit prête
L’eSIM est en général prête 5 à 15 minutes plus tard. Allo envoie alors
partner.esim.ready à votre propre endpoint webhook, pas à celui du compte. À partir de ce moment, les appels vers le numéro sonnent sur l’eSIM. Si la commande échoue, vous recevez partner.esim.failed à la place. Sans endpoint webhook, interrogez Obtenir une eSIM.5
Obtenez le code d'activation
Appelez Obtenir le code d’activation d’une eSIM. Il renvoie un QR code, les valeurs pour la saisie manuelle et le code pour construire un lien d’installation sur iPhone.
6
Remettez l'eSIM à votre client
Envoyez le QR code ou le lien d’installation à votre client, sous votre propre marque. Votre client installe l’eSIM sur son téléphone.
Allo n’envoie jamais d’email à votre client au sujet de l’eSIM. C’est vous qui lui remettez le code d’activation. Allo ne détecte pas l’installation de l’eSIM par votre client.