Pheme API : intégrez la téléphonie dans vos applications avec quelques lignes de code

Caicus lance Pheme — une API REST publique qui permet à n'importe quel développeur de déclencher des appels téléphoniques sortants avec synthèse vocale, de suivre leur statut en temps réel, et d'intégrer la téléphonie directement dans ses applications métiers.

Nommée d'après Phémé, déesse grecque des annonces publiques et de la communication, cette API expose les capacités téléphoniques de la plateforme Caicus à travers une interface simple, sécurisée et documentée. Fini les intégrations complexes : un appel HTTP suffit pour déclencher un appel téléphonique.

Qu'est-ce que Pheme ?

Pheme est l'API publique de Caicus, accessible à l'adresse pheme.caicus.net. Elle permet aux développeurs d'intégrer des appels téléphoniques automatisés dans leurs applications — CRM, outils de gestion, plateformes de rappel, systèmes de notification — sans avoir à gérer d'infrastructure téléphonique.

Concrètement, Pheme permet de :

• Déclencher un appel sortant vers n'importe quel numéro français avec un message vocal personnalisé
• Choisir la langue et la voix de synthèse (fr, en, de, tr — homme ou femme)
• Suivre en temps réel ce qui se passe pendant l'appel : sonnerie, décrochage, touches pressées, raccroché
• Vérifier le statut d'un appel à tout moment via son identifiant unique

Une documentation interactive avec Swagger UI

Pheme est entièrement documentée via Swagger UI, accessible directement à l'adresse https://pheme.caicus.net/swagger-ui.html. Les développeurs peuvent explorer, tester et comprendre chaque endpoint sans écrire une seule ligne de code.

Comment initier un appel : le flux complet

Pour déclencher un appel via Pheme, commencez par créer un compte sur web.caicus.net, puis suivez quatre étapes simples. Ce flux garantit que seuls les utilisateurs authentifiés et vérifiés peuvent utiliser les services téléphoniques. Vous bénéficierez de 100 appels gratuits après votre inscription.

Exemples de requêtes

Étape 1 — Se connecter et obtenir une clé API

curl -X POST https://pheme.caicus.net/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "votre@email.com", "password": "votre-mot-de-passe"}'

{
  "apiKey": "ff196e5beabd46fa9ccf185b81c2a198",
  "expiresAt": "2026-04-16T21:47:39",
  "error": null
}

Étape 3 — Initier un appel

curl -X POST https://pheme.caicus.net/v1/call/initiate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ff196e5beabd46fa9ccf185b81c2a198" \
  -d '{
    "numberToCall": "0033666123456",
    "speechText": "Bonjour, ceci est un rappel de votre rendez-vous demain à 14h.",
    "speechLanguage": "fr",
    "speechGender": "female"
  }'

{
  "callId": "1776268206600:0033666123456:525:-1",
  "message": "Call initiated successfully",
  "initiatedAt": "2026-04-16T17:50:07"
}

Étape 4 — Consulter le statut de l'appel

curl -X GET https://pheme.caicus.net/v1/call/1776268206600:0033666123456:525:-1/status \
  -H "X-API-Key: ff196e5beabd46fa9ccf185b81c2a198"

{
  "callId": "1776268206600:0033666123456:525:-1",
  "status": "completed",
  "events": [
    { "eventType": "RINGING",                           "eventTime": "2026-04-16T17:50:07" },
    { "eventType": "ANSWER",                            "eventTime": "2026-04-16T17:50:18" },
    { "eventType": "Called person listening to speech", "eventTime": "2026-04-16T17:50:19" },
    { "eventType": "HANGUP",                            "eventTime": "2026-04-16T17:50:20" }
  ]
}

Cas d'usage typiques

• Rappels de rendez-vous — Intégrez Pheme à votre CRM pour appeler automatiquement vos clients la veille d'un rendez-vous
• Notifications critiques — Alertez vos utilisateurs par téléphone en cas d'incident, de livraison ou d'échéance importante
• Collecte de consentement — Appelez vos contacts pour recueillir leur accord de manière traçable avant une campagne
• Confirmation de commande — Envoyez une confirmation vocale personnalisée après chaque achat
• Relances automatisées — Relancez vos prospects ou clients inactifs avec un message vocal ciblé

Sécurité et contrôle

Pheme a été conçue avec la sécurité comme priorité. Chaque clé API expire automatiquement après 4 heures — une nouvelle authentification est nécessaire pour continuer. Les clés précédentes sont automatiquement désactivées à chaque connexion.

La vérification téléphonique préalable garantit que seuls les utilisateurs ayant confirmé leur identité peuvent déclencher des appels. Chaque appel est lié au compte qui l'a initié — il est impossible de consulter le statut d'un appel qui ne vous appartient pas.

• Clés API à durée limitée (4h) — renouvellement par authentification
• Vérification téléphonique obligatoire avant le premier appel
• Isolation des données — chaque compte ne voit que ses propres appels
• HTTPS obligatoire sur tous les endpoints
• Solde minimum requis — protection contre les abus

Limites de débit (Rate Limiting)

Pour garantir la qualité de service pour tous les utilisateurs, Pheme applique des limites de débit par clé API. Ces limites sont indépendantes par endpoint et se réinitialisent toutes les 60 secondes.

Chaque réponse inclut des headers vous informant de votre consommation en temps réel :

X-RateLimit-Limit: 60        # Limite maximale pour cet endpoint
			X-RateLimit-Remaining: 47    # Requêtes restantes dans la fenêtre
			X-RateLimit-Reset: 1713278460000 # Timestamp de réinitialisation (ms)

En cas de dépassement, l'API retourne une réponse HTTP 429 :

{
			  "status": 429,
			  "error": "Too Many Requests",
			  "message": "Rate limit exceeded. Maximum 60 requests per minute for this endpoint. Please retry after 1 minute."
			}

La documentation complète et interactive est disponible à l'adresse pheme.caicus.net/swagger-ui.html.