# Allo — Help Center: French Référence API

> Documentation and support for Allo, the business phone system that does the work your calls create

## Référence API

### API

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/introduction.md): Intégrez les capacités de communication d'Allo dans vos applications
- [Authentification](https://help.withallo.com/fr/v2/api-reference/guides/authentication.md): Authentifier les requêtes API avec des API keys
- [Rate limits](https://help.withallo.com/fr/v2/api-reference/guides/rate-limits.md): Limites de requetes et headers de reponse
- [Pagination](https://help.withallo.com/fr/v2/api-reference/guides/pagination.md): Pagination par page avec totaux sur tous les endpoints de liste
- [Gestion des erreurs](https://help.withallo.com/fr/v2/api-reference/guides/error-handling.md): Reponses d'erreur standardisees avec suggestions actionnables
- [Codes d'erreur](https://help.withallo.com/fr/v2/api-reference/guides/error-codes.md): Catalogue complet de tous les codes d'erreur de l'API avec instructions de resolution
- [Cas d'utilisation courants](https://help.withallo.com/fr/v2/api-reference/guides/common-use-cases.md): Exemples d'utilisation de l'API Allo pour repondre a des questions business et automatiser des workflows

### Webhooks

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/webhooks/overview.md): Recevez des notifications en temps reel lorsque des evenements se produisent dans votre compte Allo
- [Lister les webhooks](https://help.withallo.com/fr/v2/api-reference/webhooks/get-webhooks.md): Returns all webhook endpoints configured for your account.
- [Récupérer un webhook](https://help.withallo.com/fr/v2/api-reference/webhooks/get-webhook.md): Returns a single webhook endpoint by ID, including its `signing_secret`.
- [Créer un webhook](https://help.withallo.com/fr/v2/api-reference/webhooks/create-webhook.md): Creates a webhook endpoint subscribed to one or more event topics. The `signing_secret` is returned only in this response — store it to verify delivery signatures.
- [Modifier un webhook](https://help.withallo.com/fr/v2/api-reference/webhooks/update-webhook.md): Updates a webhook endpoint. Only the fields you provide are changed. Omitted fields are left untouched.
- [Supprimer un webhook](https://help.withallo.com/fr/v2/api-reference/webhooks/delete-webhook.md): Permanently deletes a webhook endpoint and its delivery history.
- [Lister les types d'événements](https://help.withallo.com/fr/v2/api-reference/webhooks/list-event-types.md): Returns the catalog of event topics you can subscribe a webhook to.
- [Catalogue d'evenements](https://help.withallo.com/fr/v2/api-reference/webhooks/event-catalog.md): Reference complete de tous les types d'evenements webhook et leurs payloads
- [Verification des signatures webhook](https://help.withallo.com/fr/v2/api-reference/webhooks/verifying-signatures.md): Authentifiez les webhooks entrants a l'aide de signatures HMAC-SHA256
- [Livraison et nouvelles tentatives](https://help.withallo.com/fr/v2/api-reference/webhooks/delivery-and-retries.md): Comment Allo livre les webhooks, retente les echecs et gere la recuperation
- [Tester les webhooks](https://help.withallo.com/fr/v2/api-reference/webhooks/testing.md): Testez vos endpoints webhook avant la mise en production
- [Bonnes pratiques](https://help.withallo.com/fr/v2/api-reference/webhooks/best-practices.md): Recommandations pour construire des consommateurs de webhooks fiables
- [Troubleshooting](https://help.withallo.com/fr/v2/api-reference/webhooks/troubleshooting.md): Diagnostiquer et corriger les problemes courants de livraison des webhooks

### Conversations

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/conversations/overview.md): Historique unifié des appels et SMS avec recherche par mots-clés et filtrage avancé
- [Lister les conversations](https://help.withallo.com/fr/v2/api-reference/conversations/list-conversations.md): Returns a paginated list of conversations grouped by contact phone number, sorted by most recent activity.
- [Obtenir un élément de conversation](https://help.withallo.com/fr/v2/api-reference/conversations/get-item.md): Returns a single call or SMS message by its ID.
- [Rechercher des éléments de conversation](https://help.withallo.com/fr/v2/api-reference/conversations/search-conversation-items.md): Search and filter items across all conversations. Supports keyword search across transcripts, summaries, and message content.
- [Obtenir plusieurs éléments de conversation](https://help.withallo.com/fr/v2/api-reference/conversations/batch-get.md): Returns multiple conversation items by their IDs in a single request. Use this to fetch full details (summary, tags, recording, etc.) for items returned by the analytics drilldown or any other list.
- [Exécuter une action de conversation](https://help.withallo.com/fr/v2/api-reference/conversations/execute-action.md): Execute an action on a conversation.
- [Modifier le résumé d'un appel](https://help.withallo.com/fr/v2/api-reference/conversations/update-summary.md): Replace the markdown content of a call's AI-generated summary.

### CRM

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/crm/overview.md): Gérez les personnes, les entreprises et les deals de votre CRM Allo

### Personnes

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/crm/people-overview.md): Gerez les personnes dans votre CRM Allo
- [Obtenir une personne](https://help.withallo.com/fr/v2/api-reference/crm/get-person.md): Returns a single person by ID.
- [Creer une personne](https://help.withallo.com/fr/v2/api-reference/crm/create-person.md): Creates a new person in your CRM.
- [Mettre a jour une personne](https://help.withallo.com/fr/v2/api-reference/crm/update-person.md): Updates an existing person. Only provided fields will be updated.
- [Rechercher des personnes](https://help.withallo.com/fr/v2/api-reference/crm/search-people.md): Search and filter people in your CRM with advanced filtering, sorting, and pagination.

### Entreprises

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/crm/companies-overview.md): Gerez les entreprises dans votre CRM Allo
- [Obtenir une entreprise](https://help.withallo.com/fr/v2/api-reference/crm/get-company.md): Returns a single company by ID.
- [Creer une entreprise](https://help.withallo.com/fr/v2/api-reference/crm/create-company.md): Creates a new company in your CRM.
- [Mettre a jour une entreprise](https://help.withallo.com/fr/v2/api-reference/crm/update-company.md): Updates an existing company. Only provided fields will be updated.
- [Rechercher des entreprises](https://help.withallo.com/fr/v2/api-reference/crm/search-companies.md): Search and filter companies in your CRM.

### Deals

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/crm/deals-overview.md): Accedez aux deals synchronises depuis vos integrations CRM
- [Rechercher des deals](https://help.withallo.com/fr/v2/api-reference/crm/search-deals.md): Search and filter deals in your CRM.
- [Obtenir un deal](https://help.withallo.com/fr/v2/api-reference/crm/get-deal.md): Returns a single deal by ID.

### Notes

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/notes/overview.md): Notes internes d'équipe sur les conversations et les fiches de personnes, avec @mentions
- [Lister les notes de conversation](https://help.withallo.com/fr/v2/api-reference/notes/list-conversation-notes.md): Returns the internal team notes on a conversation, paginated.
- [Créer une note de conversation](https://help.withallo.com/fr/v2/api-reference/notes/create-conversation-note.md): Adds an internal team note to a conversation. Notes are never visible to the contact.
- [Obtenir une note de conversation](https://help.withallo.com/fr/v2/api-reference/notes/get-conversation-note.md): Returns a single conversation note by ID.
- [Mettre à jour une note de conversation](https://help.withallo.com/fr/v2/api-reference/notes/update-conversation-note.md): Updates a note's content. Only the note's author can edit it.
- [Supprimer une note de conversation](https://help.withallo.com/fr/v2/api-reference/notes/delete-conversation-note.md): Deletes a note. Only the note's author can delete it.
- [Lister les notes d'une personne](https://help.withallo.com/fr/v2/api-reference/notes/list-person-notes.md): Returns the notes on a person's CRM profile, paginated.
- [Créer une note de personne](https://help.withallo.com/fr/v2/api-reference/notes/create-person-note.md): Adds a note to a person's CRM profile.
- [Mettre à jour une note de personne](https://help.withallo.com/fr/v2/api-reference/notes/update-person-note.md): Updates a person note's content. Only the note's author can edit it.
- [Supprimer une note de personne](https://help.withallo.com/fr/v2/api-reference/notes/delete-person-note.md): Deletes a person note. Only the note's author can delete it.

### Fils de discussion

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/threads/overview.md): Fils de discussion d'équipe attachés aux appels, SMS et notes de conversation
- [Obtenir un fil de discussion](https://help.withallo.com/fr/v2/api-reference/threads/get-thread.md): Returns a thread with all its comments.
- [Trouver un fil de discussion](https://help.withallo.com/fr/v2/api-reference/threads/find-thread.md): Finds the discussion thread attached to a conversation item. Returns zero or one thread — each item has at most one thread.
- [Créer un fil de discussion](https://help.withallo.com/fr/v2/api-reference/threads/create-thread.md): Starts a discussion thread on a conversation item with a first comment. Each item can have only one thread.
- [Ajouter un commentaire](https://help.withallo.com/fr/v2/api-reference/threads/create-comment.md): Adds a comment to an existing thread.
- [Mettre à jour un commentaire](https://help.withallo.com/fr/v2/api-reference/threads/update-comment.md): Updates a comment's content. Only the comment's author can edit it.
- [Résoudre un fil de discussion](https://help.withallo.com/fr/v2/api-reference/threads/resolve-thread.md): Marks a thread as resolved.
- [Rouvrir un fil de discussion](https://help.withallo.com/fr/v2/api-reference/threads/unresolve-thread.md): Reopens a resolved thread.

### Numéros de téléphone

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/phone-numbers/overview.md): Accedez a vos numeros de telephone Allo, identifiants d'expediteur et leurs capacites
- [Lister les numeros de telephone](https://help.withallo.com/fr/v2/api-reference/phone-numbers/list-numbers.md): Returns all phone numbers and sender IDs on your team.
- [Récupérer le flux d'appel](https://help.withallo.com/fr/v2/api-reference/phone-numbers/get-call-flow.md): Returns the call flow for a phone number. By default returns the published flow (or an in-memory synthesis of the legacy IVR if none is published); pass `?status=draft` to return the working draft instead.
- [Récupérer le brouillon du flux d'appel](https://help.withallo.com/fr/v2/api-reference/phone-numbers/get-call-flow-draft.md): Returns the working draft of a phone number's call flow. Unlike `GET /v2/api/numbers/{number}/call_flow?status=draft`, this endpoint does NOT fall back to the published flow when no draft exists — it returns `404 CALL_FLOW_DRAFT_NOT_FOUND`. Use it to read a draft's `lock_version` without risk of acc…
- [Enregistrer le brouillon du flux d'appel](https://help.withallo.com/fr/v2/api-reference/phone-numbers/save-call-flow-draft.md): Creates or updates the working draft of a phone number's call flow. The draft is validated leniently and is not live until published. Optimistic concurrency: pass the `lock_version` returned by a previous read to detect a concurrent edit, and `base_published_version` to detect a publish that happene…
- [Publier le flux d'appel](https://help.withallo.com/fr/v2/api-reference/phone-numbers/publish-call-flow.md): Publishes the working draft, making it the live call flow for the phone number. This changes live inbound routing immediately. Runs full validation, which is stricter than the lenient validation a draft save runs, so a draft that saved successfully can still fail to publish; the whole publish rolls…

### Réceptionniste IA

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/agent/overview.md): Lisez et modifiez le réceptionniste IA d'une ligne Allo : prompt, voix, horaires, règles de transfert, agendas et connaissances
- [Lire la configuration](https://help.withallo.com/fr/v2/api-reference/agent/get-agent.md): Returns the whole configuration of a line's AI receptionist in one call: business details, voice and language, prompt, capabilities, business hours, transfer rules, connected calendars and knowledge sources. Call this before a write, because `PATCH` replaces whole collections.
- [Modifier la configuration](https://help.withallo.com/fr/v2/api-reference/agent/update-agent.md): Updates any part of the configuration except the prompt and the on/off status. Single values are merged, collections are replaced. This does not put the receptionist on the line: that is `PUT /v2/api/numbers/{number}/agent/status`.
- [Définir le prompt](https://help.withallo.com/fr/v2/api-reference/agent/set-agent-prompt.md): Replaces the receptionist's prompt: what it is trying to achieve, who it is, how it handles the call. A prompt is only valid whole, so read the current sections with `GET /v2/api/numbers/{number}/agent` and send them all back, including the ones you are not changing. Facts about the business belong…
- [Activer ou désactiver](https://help.withallo.com/fr/v2/api-reference/agent/set-agent-status.md): Puts the receptionist on the line (`ACTIVE`) or takes it off (`FORWARDING`, which sends calls to your business phone instead). This reprograms how a live line routes real calls, so confirm with a person before calling it.
- [Ajouter un site web](https://help.withallo.com/fr/v2/api-reference/agent/add-website-knowledge.md): Adds a page to the receptionist's knowledge. Allo scrapes and summarizes it during the request, so the call takes a few seconds. Up to 5 websites per receptionist.
- [Activer ou désactiver un site](https://help.withallo.com/fr/v2/api-reference/agent/update-website-knowledge.md): Turns a website entry on or off without losing its scraped content.
- [Supprimer un site web](https://help.withallo.com/fr/v2/api-reference/agent/delete-website-knowledge.md): Removes a website entry from the receptionist's knowledge.
- [Supprimer un document](https://help.withallo.com/fr/v2/api-reference/agent/delete-file-knowledge.md): Removes an uploaded document from the receptionist's knowledge. Documents are uploaded in the Allo app; this API lists and deletes them.
- [Lister les agendas](https://help.withallo.com/fr/v2/api-reference/agent/list-calendars.md): Lists the calendars connected to your workspace that you can see, whether or not a receptionist books on them. An admin sees every calendar in the workspace, a team member only the ones they connected. Connecting a calendar is an OAuth flow done in the Allo app.
- [Lire un agenda](https://help.withallo.com/fr/v2/api-reference/agent/get-calendar.md): Returns one connected calendar with the event types its provider currently offers, read live from the provider. This is the catalog you pick from when filling `scheduling.calendars`.
- [Lister les voix](https://help.withallo.com/fr/v2/api-reference/agent/list-voices.md): Lists the voices an AI receptionist can speak with, the same catalog the Allo app offers. Each `id` is what `voice_id` takes, and a voice speaks the language it is listed under.

### Tags

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/tags/overview.md): Decouvrez les tags d'appel disponibles pour filtrer les conversations
- [Lister les tags](https://help.withallo.com/fr/v2/api-reference/tags/list-tags.md): Returns all tags configured on the team.
- [Creer un tag](https://help.withallo.com/fr/v2/api-reference/tags/create-tag.md): Creates a new tag on the team. The tag key is auto-generated by slugifying the name.
- [Supprimer un tag](https://help.withallo.com/fr/v2/api-reference/tags/delete-tag.md): Soft-deletes a tag by its key. Tags synced from a CRM integration cannot be deleted via the API.
- [Ajouter des tags](https://help.withallo.com/fr/v2/api-reference/tags/add-tags.md): Add one or more tags to a conversation item.
- [Supprimer un tag](https://help.withallo.com/fr/v2/api-reference/tags/remove-tag.md): Remove a tag from a conversation item.

### Modèles de résumé

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/summary-templates/overview.md): Gerez les modeles de resume d'appel qui structurent les resumes generes par l'IA
- [Lister les modeles de resume](https://help.withallo.com/fr/v2/api-reference/summary-templates/list-summary-templates.md): Returns the team's call summary templates.
- [Recuperer un modele de resume](https://help.withallo.com/fr/v2/api-reference/summary-templates/get-summary-template.md): Returns a single call summary template by ID.
- [Creer un modele de resume](https://help.withallo.com/fr/v2/api-reference/summary-templates/create-summary-template.md): Creates a call summary template for the team.
- [Mettre a jour un modele de resume](https://help.withallo.com/fr/v2/api-reference/summary-templates/update-summary-template.md): Replaces a summary template's name, call context, icon, and sections.
- [Supprimer un modele de resume](https://help.withallo.com/fr/v2/api-reference/summary-templates/delete-summary-template.md): Soft-deletes (deactivates) a summary template.
- [Definir le modele par defaut d'un numero](https://help.withallo.com/fr/v2/api-reference/summary-templates/set-number-default-summary-template.md): Sets or clears the default summary template used for a phone number's call summaries. Pass `summary_template_id` to set it, or null/omit to clear it.

### Utilisateurs

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/users/overview.md): Accedez a la liste de votre equipe avec roles et statuts
- [Me](https://help.withallo.com/fr/v2/api-reference/users/me.md): Returns information about the authenticated API key: its scopes, available endpoints, team, and rate limits. No specific scope is required — any valid API key can call this endpoint.
- [Lister les utilisateurs](https://help.withallo.com/fr/v2/api-reference/users/list-users.md): Returns all team members.
- [Obtenir un utilisateur](https://help.withallo.com/fr/v2/api-reference/users/get-user.md): Returns a single team member by their ID.

### SMS

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/sms/overview.md): Envoyez des SMS et MMS par programmation
- [Envoyer un SMS](https://help.withallo.com/fr/v2/api-reference/sms/send-sms.md): Send an SMS message to a US phone number using one of your Allo phone numbers. The recipient must be in the same country as your Allo number.
- [Envoyer un SMS (France)](https://help.withallo.com/fr/v2/api-reference/sms/send-sms-france.md): Send an SMS message to a French phone number using a verified Sender ID. The Sender ID must be verified by the Allo team before use. Contact support to register your Sender ID.

### Analytiques

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/analytics/overview.md): Metriques d'appels pre-calculees et analytiques de performance d'equipe
- [Metriques d'equipe](https://help.withallo.com/fr/v2/api-reference/analytics/team-summary.md): Returns team-wide KPIs with period-over-period comparison and a per-user breakdown. Covers all calls (inbound + outbound).
- [Metriques sortantes](https://help.withallo.com/fr/v2/api-reference/analytics/outbound.md): Returns outbound call metrics: dial funnel (dials → connected → conversations → conversions), time series, heatmap, leaderboard, and time spent metrics.

### Power Dialer

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/dialing-queues/overview.md): Gerez les files Power Dialer par programmation
- [Lister les numeros de la file courante](https://help.withallo.com/fr/v2/api-reference/dialing-queues/get-current.md): Returns the numbers in the Power Dialer queue currently assigned to the authenticated user, paginated and ordered by `position` ascending. `data` is the list of numbers (use `page`/`size` and read `pagination` to page through them); the `queue` key carries the queue's metadata (id, name, settings) w…
- [Mettre a jour la file courante](https://help.withallo.com/fr/v2/api-reference/dialing-queues/update-current.md): Creates or updates the config of the queue assigned to the authenticated user. Send `user_id` or `email` to act on a teammate's queue instead — `user_id` wins when both are provided.
- [Ajouter des numeros](https://help.withallo.com/fr/v2/api-reference/dialing-queues/append-numbers.md): Appends phone numbers to the Power Dialer queue assigned to the authenticated user. Creates the queue implicitly if none exists. Send `user_id` or `email` to append to a teammate's queue — if that teammate has no current queue, one is created with the API key owner as `creator_id` and the teammate a…
- [Vider les numeros de la file](https://help.withallo.com/fr/v2/api-reference/dialing-queues/clear-numbers.md): Removes numbers from the queue assigned to the authenticated user. Exactly one filter must be supplied via query string: `number` (E.164), `position` (0-based index), `number` + `position` together (delete a specific occurrence of a duplicate), or `unassigned=true` (remove every entry that has not b…
- [Reinitialiser la file courante](https://help.withallo.com/fr/v2/api-reference/dialing-queues/reset-current.md): Creates a fresh, empty queue assigned to the authenticated user. Any older queue with the same assignee stops being returned by `GET /current` (the newest queue wins). Send `user_id` or `email` to create the queue for a teammate instead — the API key owner is recorded as `creator_id`, the teammate a…

### Partner

- [Vue d'ensemble](https://help.withallo.com/fr/v2/api-reference/partner/overview.md): Provisionnez et gérez des comptes Allo pour vos clients en tant que revendeur.
- [Créer un compte](https://help.withallo.com/fr/v2/api-reference/partner/create-account.md): Creates an Allo account for one of your customers, provisions a phone number, and returns a scoped API key for the account. Requires the `PARTNER` scope. The account is billed as one seat on your subscription.
- [Obtenir un compte](https://help.withallo.com/fr/v2/api-reference/partner/get-account.md): Returns the status and activation state of an account you provisioned. Requires the `PARTNER` scope.
- [Désactiver un compte](https://help.withallo.com/fr/v2/api-reference/partner/delete-account.md): Deactivates an account you provisioned and releases its seat. The account stays active until the end of the current paid period, then expires. Requires the `PARTNER` scope.