ENSe connecterEssayer 7 jours

Documentation

Démarrage rapide

Passe ton premier appel en moins de cinq minutes.

Allomi te donne un assistant téléphonique IA avec un vrai numéro. Tu lui parles depuis l'application web, ou tu le donnes à tes logiciels et à tes agents via l'API, le SDK, la CLI ou MCP.

1. Crée un compte

Inscris-toi sur allomi.ai avec ton numéro de mobile (tu reçois un code par SMS) ou par lien magique envoyé par e-mail. Choisis un nom et une voix pour ton assistant. Il t'appelle dans la minute, depuis un numéro de démonstration partagé : tu l'entends avant de faire quoi que ce soit d'autre.

Les offres cloud démarrent par 7 jours d'essai (carte requise). L'auto-hébergement est gratuit : voir Auto-hébergement.

2. Crée une clé d'API

Ouvre Connecteurs et API dans l'application et crée une clé. Elle ressemble à alm_live_… (vrais appels) ou alm_test_…. La clé complète n'est affichée qu'une fois : garde-la comme un secret.

export ALLOMI_API_KEY="alm_live_…"

Les clés ont des portées (par exemple calls:write, calls:read, contacts:read). Donne à chaque intégration seulement ce dont elle a besoin.

3. Passe un appel

Avec curl :

curl https://api.allomi.ai/v1/calls \
  -H "Authorization: Bearer $ALLOMI_API_KEY" \
  -H "Idempotency-Key: 6f1c2b8e-2d3a-4b5c-9e8f-7a6b5c4d3e2f" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+33199000001",
    "prompt": "Réserve une table pour 4 ce soir à 20 h, demande un coin calme.",
    "language": "fr",
    "maxMinutes": 5
  }'

Avec le SDK TypeScript :

import { Allomi } from "allomi";

const allomi = new Allomi({ apiKey: process.env.ALLOMI_API_KEY });
const call = await allomi.calls.create({
  to: "+33199000001",
  prompt: "Réserve une table pour 4 ce soir à 20 h, demande un coin calme.",
  language: "fr",
  maxMinutes: 5,
});
console.log(call.id, call.status); // queued

L'appel démarre à l'état queued, passe par ringing et in_progress, puis se termine en completed, no_answer, busy, failed ou canceled.

4. Récupère le résultat

Soit tu interroges l'appel, soit tu reçois un webhook à sa fin :

const done = await allomi.calls.get(call.id);
console.log(done.status, done.summary);

En production, les webhooks sont préférables : voir Webhooks.

Pour aller plus loin