> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shortext.ny-corp.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Gérer plusieurs entreprises avec un seul compte

> Intégrateurs et agences peuvent gérer toutes leurs entreprises clientes depuis un seul compte Shortext, avec un agent par client et une seule facture.

Vous intégrez Shortext pour **plusieurs entreprises** : vos clients, vos franchises, les marques d'un groupe. Inutile d'ouvrir un compte Shortext par entreprise. Créez **un agent par entreprise** dans votre propre compte, et rattachez à chaque agent les canaux de cette entreprise.

## Le modèle

```mermaid theme={null}
flowchart LR
    subgraph ACC["Votre compte Shortext : une facture, une clé API"]
        direction TB
        A1["Agent : entreprise A"]
        A2["Agent : entreprise B"]
        A3["Agent : entreprise C"]
    end
    A1 --- W1["WhatsApp +237 6.. (A)"]
    A1 --- M1["Boîte mail support@a.com"]
    A2 --- W2["WhatsApp +33 6.. (B)"]
    A2 --- W3["WhatsApp +33 7.. (B, ventes)"]
    A3 --- S3["Endpoint Shortext : appli de C"]
    A3 --- M3["Boîte mail hello@c.com"]
```

* **Une entreprise = un agent.** L'agent porte l'identité de l'entreprise : son nom, ses instructions (ton, règles, ce qu'il peut dire), sa base de connaissances, ses outils, ses tickets.
* **Un agent, plusieurs canaux.** Un agent peut répondre sur autant de canaux que l'entreprise en possède : plusieurs numéros WhatsApp, des boîtes mail, des endpoints Shortext pour ses applications. Toutes les conversations de ces canaux reçoivent la réponse de l'agent de l'entreprise.
* **Un compte, une facture.** Toute la consommation est débitée du portefeuille unique de votre compte. Vous gérez un abonnement, un solde et une série de factures, quel que soit le nombre d'entreprises.

## Ce que chaque agent garde séparé

Tout ce qui définit la façon dont une entreprise est servie appartient à son agent :

| Par agent | Où |
| - | - |
| Instructions et réglages de l'IA | [Créer un agent](https://docs.shortext.ny-corp.io/fr/agents/creating-an-agent.md) |
| Base de connaissances et connaissances de contact | [Connaissances de l'agent](https://docs.shortext.ny-corp.io/fr/api-reference/guides/agent-knowledge.md) |
| Outils (appels aux API de l'entreprise) | [Outils](https://docs.shortext.ny-corp.io/fr/agents/tools-configuration.md) |
| Canaux (numéros WhatsApp, boîtes mail, endpoints Shortext) | [Canaux](https://docs.shortext.ny-corp.io/fr/channels/overview.md) |
| Statuts de tickets et politiques de SLA | [Gérer les tickets](https://docs.shortext.ny-corp.io/fr/api-reference/guides/manage-tickets.md) |
| Applications ouvertes par les liens dynamiques | [Liens dynamiques](https://docs.shortext.ny-corp.io/fr/api-reference/guides/dynamic-links.md) |

Et l'API permet de travailler entreprise par entreprise : filtrer les conversations avec `agent_id`, filtrer les tickets avec `agent_id`, et limiter un endpoint webhook à un agent avec `filters.app`.

## Mise en place

**1. Créez un agent par entreprise**

Dans **Communication > Agents IA**, ou avec `POST /agents`. Donnez-lui le nom de l'entreprise, pour que votre équipe le reconnaisse dans la boîte de réception. Rédigez des instructions qui parlent au nom de cette entreprise.

**2. Rattachez les canaux de l'entreprise à son agent**

Connectez chaque numéro WhatsApp, boîte mail ou endpoint Shortext et choisissez l'agent de l'entreprise. Vous pouvez aussi laisser l'entreprise connecter elle-même son numéro WhatsApp ou sa boîte mail depuis votre produit grâce à une [session hébergée](https://docs.shortext.ny-corp.io/fr/api-reference/guides/connect-whatsapp.md), en passant `context.agent_id` : le nouveau canal est directement rattaché au bon agent.

> [!WARNING]
>
> Passez toujours `context.agent_id` quand vous servez plusieurs entreprises : sans lui, le nouveau canal est rattaché au premier agent de votre compte.

**3. Donnez à chaque agent ses connaissances et ses outils**

Chargez les documents de l'entreprise et configurez les outils qui appellent ses systèmes.

**4. Acheminez les événements par entreprise**

Créez un endpoint webhook par entreprise avec `"filters": { "app": "AGI-XXXXX" }`, ou un seul endpoint qui aiguille selon l'agent de chaque événement (`channel_id`, conversation).

## Points à anticiper

* **Limite d'agents.** Votre forfait fixe le nombre d'agents de votre compte, donc le nombre d'entreprises que vous pouvez servir. Voir [Limite d'agents de votre forfait](https://docs.shortext.ny-corp.io/fr/agents/creating-an-agent.md#limite-d’agents-de-votre-forfait).
* **Accès de l'équipe.** Les membres de votre compte voient les conversations de tous les agents, dans la limite de leur rôle. Shortext ne limite pas un membre à un seul agent : donnez l'accès au tableau de bord à votre propre équipe, et si une entreprise doit voir ses conversations, construisez cette vue dans votre produit avec l'API, filtrée par `agent_id`.
* **Refacturer vos clients.** Le portefeuille est commun : les mouvements ne sont pas ventilés par agent. Pour refacturer chaque entreprise, mesurez son activité via l'API, par exemple ses conversations avec `GET /conversations?agent_id=...`.
* **Une clé API pour tous.** Les clés API appartiennent à votre compte et donnent accès à tous les agents. Gardez-les sur vos serveurs ; n'en confiez jamais une à une entreprise cliente.

> [!TIP]
>
> Une entreprise qui a besoin de sa propre facturation, de sa propre équipe avec des accès séparés ou de ses propres clés API doit plutôt avoir son propre compte Shortext.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.