# Vue d'ensemble

> Gerez les entreprises dans votre CRM Allo

L'API Companies vous permet de creer, lire, mettre a jour et rechercher les entreprises de votre equipe.

## Scopes

| Scope | Acces |
|-------|-------|
| `CRM_READ` | Obtenir et rechercher des entreprises |
| `CRM_WRITE` | Créer et mettre à jour des entreprises, et créer et mettre à jour des attributs personnalisés |
| `CRM_DELETE` | Supprimer des attributs personnalisés |

## Associations

- **Company → People** : Une entreprise peut avoir plusieurs personnes associees
- **Company → Deals** : Une entreprise peut avoir des deals lies

## Recherche

Les entreprises peuvent etre recherchees via `POST /v2/api/crm/companies/search` avec des filtres nommes.

Filtres disponibles : `name`, `website`, `industry`.

## Attributs personnalisés

Les attributs personnalisés ajoutent vos propres données aux entreprises, comme un segment ou une date de renouvellement. Types : `TEXT`, `NUMBER`, `DATE`, `BOOLEAN` et `DROPDOWN`. Chaque attribut peut porter un `prompt` qui indique à l'AI CRM Manager comment le remplir à partir des appels. Les attributs synchronisés depuis une intégration CRM sont aussi listés, avec leur `source`. Seules les équipes sur le nouveau modèle de contacts peuvent les utiliser.

Les attributs sont les définitions. `custom_attributes` contient les valeurs : définissez-les avec `custom_attributes` sur [Créer une entreprise](/fr/docs/crm/create-company) et [Mettre à jour une entreprise](/fr/docs/crm/update-company), et relisez-les dans chaque réponse d'entreprise.

## Endpoints

<CardGroup cols={1}>
  <Card title="Obtenir une entreprise" href="/fr/docs/crm/get-company">Obtenir une entreprise par ID</Card>
  <Card title="Creer une entreprise" href="/fr/docs/crm/create-company">Creer une nouvelle entreprise</Card>
  <Card title="Mettre a jour une entreprise" href="/fr/docs/crm/update-company">Mettre a jour une entreprise</Card>
  <Card title="Rechercher des entreprises" href="/fr/docs/crm/search-companies">Rechercher des entreprises avec des filtres</Card>
  <Card title="Lister les attributs d'entreprise" href="/fr/docs/crm/list-company-attributes">Lister les attributs personnalisés des entreprises</Card>
  <Card title="Créer un attribut d'entreprise" href="/fr/docs/crm/create-company-attribute">Créer un attribut personnalisé d'entreprise</Card>
  <Card title="Mettre à jour un attribut d'entreprise" href="/fr/docs/crm/update-company-attribute">Mettre à jour un attribut personnalisé d'entreprise</Card>
  <Card title="Supprimer un attribut d'entreprise" href="/fr/docs/crm/delete-company-attribute">Supprimer un attribut personnalisé d'entreprise</Card>
</CardGroup>
