Passer au contenu principal
La marque blanche s’adresse aux partenaires qui construisent leur propre produit sur l’API d’Allo. Leurs utilisateurs finaux n’utilisent jamais l’application Allo : ils utilisent l’outil du partenaire, et leur numéro Allo fait sonner une eSIM dans leur téléphone. Le logiciel du partenaire gère tout le reste par l’API : membres, numéros, eSIM, suspensions et Sender ID. Si vous revendez Allo et que vos clients utilisent l’application Allo, les endpoints Partenaires vous suffisent. Les endpoints marque blanche utilisent la même clé PARTNER, la même authentification et la même facturation que les endpoints Partenaires. Commencez par la vue d’ensemble Partenaires pour obtenir l’accès, puis créez chaque compte avec Créer un compte.

Comment ajouter des numéros et des membres à un compte

Un compte démarre avec un numéro. Vous pouvez ensuite le compléter depuis l’API :
  • Ajouter un numéro donne un numéro de plus au compte. Il est facturé sur l’abonnement du compte, sauf si le compte paie déjà un emplacement de numéro libre. Appelez d’abord Obtenir le prix d’un numéro pour connaître le montant.
  • Ajouter un membre ajoute un collaborateur au compte, avec son propre numéro. Le membre occupe un siège sur l’abonnement du compte, et ce siège inclut son numéro. Allo n’envoie aucun email d’invitation au membre : c’est vous qui l’accompagnez.
  • Lister les membres renvoie les membres du compte et leurs numéros.
  • Retirer un membre retire un membre du compte et garde ses numéros sur le compte.
Allo vérifie qu’un numéro est disponible avant tout débit. Si aucun ne correspond, la requête échoue avec 409 NO_NUMBER_AVAILABLE et rien n’est débité.

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. Ajouter un numéro et Ajouter un membre acceptent le même esim: true pour les numéros ajoutés ensuite.
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. Pour le numéro d’un membre, envoyez l’id du membre comme holder_id. Allo débite la commande sur votre crédit prépayé en priorité, puis sur votre carte enregistrée, 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.

Comment suspendre un compte pour factures impayées

Quand votre client ne vous paie plus, appelez Suspendre un compte. Les appels, les SMS sortants, la réceptionniste IA et les lignes eSIM du compte s’arrêtent immédiatement, pour tous les membres. Le compte garde ses numéros, ses eSIM et son historique. Quand votre client a payé, appelez Réactiver un compte. Tout fonctionne à nouveau, sur les mêmes numéros.

Comment remplacer un collaborateur qui part

Quand un collaborateur quitte l’entreprise de votre client, vous pouvez couper son téléphone, puis donner son numéro, avec son historique, à la personne qui le remplace.
1

Retirez le collaborateur

Appelez Retirer un membre (DELETE /v2/api/partner/accounts/{id}/members/{member_id}). Allo révoque ses eSIM immédiatement : son téléphone cesse de sonner. Ses numéros restent sur le compte et sonnent sur les apps Allo. Son siège reste payé jusqu’à la fin de la période en cours, puis les numéros sont facturés comme numéros supplémentaires.
2

Ajoutez le nouveau collaborateur sur le même numéro

Appelez Ajouter un membre avec le numéro conservé comme phone_number, à la place de number_preference. Le nouveau membre reprend le numéro avec son historique d’appels et de messages, sur un siège facturé comme pour tout nouveau membre. Comme le siège inclut le numéro, Allo retire un numéro supplémentaire de l’abonnement.
3

Donnez une eSIM au nouveau collaborateur

Appelez Commander une eSIM avec le même phone_number et l’id du nouveau membre comme holder_id. La commande facture les frais de mise en service. Remettez ensuite l’eSIM comme d’habitude, dès réception de partner.esim.ready.
Pour couper une seule eSIM sans retirer personne, par exemple pour un téléphone perdu, appelez Révoquer une eSIM.

Comment permettre à un compte d’envoyer des SMS sous le nom de sa marque

Un Sender ID est le nom que les destinataires voient à la place d’un numéro, par exemple PLOMBMARTIN. En France, les SMS automatisés ne peuvent pas partir d’un numéro mobile : le Sender ID est donc ce qui permet à votre logiciel d’écrire aux clients du compte.
1

Déclarez le Sender ID

Appelez Déclarer un Sender ID avec le nom, de 1 à 11 lettres ou chiffres, et un exemple de message optionnel. Un Sender ID n’appartient qu’à un seul compte Allo, et un compte en détient au plus 3. Le Sender ID démarre avec le statut PENDING.
2

Attendez la validation d'Allo

Allo valide le Sender ID à la main, en général en 1 à 5 jours ouvrés. Allo envoie ensuite partner.sender_id.validated ou partner.sender_id.failed à votre propre endpoint webhook, pas à celui du compte. Sans endpoint webhook, interrogez Obtenir un Sender ID.
3

Envoyez des SMS avec lui

Une fois le Sender ID VALIDATED, le compte envoie des SMS avec Envoyer un SMS (France) : POST /v1/api/sms avec sender_id à la place de from, avec la clé API du compte, qui doit porter le scope SMS_SEND.
Allo peut désactiver un Sender ID après l’avoir validé. Son statut passe à DISABLED et l’envoi avec lui est refusé. Aucun webhook n’est envoyé pour ce changement : consultez Obtenir un Sender ID ou Lister les Sender ID pour le vérifier.

Comment modifier les données d’une eSIM

Chaque eSIM a un palier de données, renouvelé avec l’abonnement que vous payez pour le compte. Vous pouvez le changer, ou ajouter des données pour le mois en cours, depuis l’API :
  • Changer le palier d’une eSIM fait passer l’eSIM à un autre palier. Une montée de palier est débitée tout de suite, au prorata du reste de la période de facturation, et ses données en plus sont ajoutées en une minute environ. Une baisse de palier s’applique à la fin de la période déjà payée, et rien n’est remboursé.
  • Acheter une recharge de données eSIM ajoute 5, 10 ou 20 Go à l’eSIM pour le mois civil en cours (heure de Paris), contre un débit unique. Les données de recharge non utilisées sont perdues à la fin de ce mois.
Les deux sont débités comme tout débit partenaire : crédit prépayé d’abord, puis carte enregistrée. Obtenir l’offre eSIM renvoie le prix des paliers et des recharges. Envoyez un en-tête Idempotency-Key avec ces deux requêtes, pour qu’une nouvelle tentative ne vous débite jamais deux fois. Il est obligatoire pour acheter une recharge. Obtenir une eSIM renvoie les données utilisées ce mois-ci dans data. Quand une eSIM atteint son quota, les données mobiles s’arrêtent jusqu’au mois suivant ou jusqu’à une recharge, mais les appels et les SMS continuent de fonctionner. Allo envoie partner.esim.data_low à 80 % du quota et partner.esim.data_exhausted à 100 %.

Endpoints

Les comptes se tarifent, se créent, se consultent et se désactivent avec les endpoints Partenaires.