> ## Documentation Index > Fetch the complete documentation index at: https://help.withallo.com/llms.txt > Use this file to discover all available pages before exploring further. # Vue d'ensemble > Integrez les capacites de communication d'Allo dans vos applications L'API Allo permet aux developpeurs d'integrer directement les capacites de communication d'Allo dans leurs applications. Creez des integrations CRM, automatisez les workflows post-appel, synchronisez les donnees de conversation et alimentez des agents IA avec l'historique des appels et SMS de votre equipe. ## Pour commencer Avant d'utiliser l'API, assurez-vous d'avoir : * Un abonnement Allo actif * Les permissions Admin ou Manager sur votre workspace * Une API key generee depuis [Parametres > API](https://web.withallo.com/settings/api) ## Documentation de l'API Configuration des API keys et scopes Limites de requetes et headers Resultats pagines avec totaux Format des erreurs et resolution ## Fonctionnalites principales L'API donne acces a : * **Conversations** — consultez l'historique des appels et SMS dans une timeline unifiee, avec recherche par mots-cles dans les transcriptions et le contenu des messages * **Notes & Fils de discussion** — ajoutez des notes internes d'équipe sur les conversations et les fiches de personnes, et discutez des éléments dans des fils avec @mentions * **Webhooks** — recevez des notifications en temps reel lorsque des appels se terminent, des messages arrivent, des tags sont ajoutes, des notes et fils changent et des contacts changent * **Numeros de telephone** — listez vos numeros Allo avec leurs capacites, le statut du sender ID et les acces des membres * **Utilisateurs** — accedez a la liste de votre equipe avec les roles et les numeros assignes * **Tags** — decouvrez les tags d'appels disponibles pour le filtrage et le reporting ## Authentification Les API keys sont generees depuis les parametres de votre workspace. Incluez la cle dans le header `Authorization` de chaque requete : ```bash theme={null} curl -X GET "https://api.withallo.com/v2/api/conversations" \ -H "Authorization: Api-Key ak_live_your_key_here" ``` Stockez votre API key de maniere securisee. Ne l'exposez pas dans du code cote client ou des depots publics. ## Rate limiting Les rate limits varient selon le type de requete : | Operation | Limite | | ---------------------------------------------- | ------------------- | | Requetes de lecture (GET) | 20 requetes/seconde | | Requetes d'ecriture (POST, PUT, PATCH, DELETE) | 5 requetes/seconde | Chaque reponse inclut les headers `X-RateLimit-Limit`, `X-RateLimit-Remaining` et `X-RateLimit-Reset` pour que vous puissiez surveiller votre utilisation. Voir [Rate limits](/fr/v2/api-reference/guides/rate-limits) pour les details. ## Exemple rapide Obtenez vos conversations recentes : ```bash theme={null} curl -X GET "https://api.withallo.com/v2/api/conversations?size=5" \ -H "Authorization: Api-Key ak_live_your_key_here" ``` ```json theme={null} { "data": [ { "contact_number": "+14155551234", "contacts": [{ "id": "cnt-abc", "name": "Sarah Johnson", "company": { "name": "Acme Corp" } }], "last_activity": "2026-04-21T14:30:00Z", "last_item": { "id": "cll-abc123", "type": "CALL", "direction": "INBOUND", "result": "ANSWERED", "summary": "Customer called about upgrading their plan.", "duration": 145 } } ], "pagination": { "page": 1, "size": 5, "total_count": 156, "has_more": true } } ``` ## Endpoints Timeline unifiee appels + SMS avec filtrage par date, recherche par mots-cles et donnees de contact enrichies Notifications d'evenements en temps reel avec signatures HMAC et tentatives automatiques Vos numeros Allo avec leurs capacites, le statut du sender ID et les acces des membres Liste de l'equipe avec roles et numeros assignes Tags d'appels disponibles pour filtrer les conversations Notes internes d'équipe sur les conversations et les fiches de personnes, avec @mentions Fils de discussion d'équipe sur les appels, SMS et notes de conversation