Tous les endpoints CRM Lookup sont scopés au workspace et requièrent les scopes OAuth client et crm. Ces endpoints sont appelés par le Middleware CRM lors des événements PBX (appels entrants, appels sortants, sessions de chat).

En-têtes : Authorization: Bearer {workspace-token}

Le contexte client est résolu automatiquement depuis le token OAuth.

GET /api/crm/lookup/contacts/search

Recherche des contacts dans le CRM connecté par numéro de téléphone ou adresse email. Généralement appelé lors d'un screen-pop quand un appel sonne sur le PBX.

Paramètres de requête

*Au moins phone ou email est requis.

Réponse 200

{
  "contacts": [
    {
      "id": "crm-contact-uuid",
      "first_name": "Alice",
      "last_name": "Martin",
      "email": "alice.martin@acme.com",
      "phone_business_1": "+33142000000",
      "phone_mobile_1": "+33612345678",
      "company": "Acme Corp",
      "entity_url": "https://crm.example.com/contacts/123"
    }
  ]
}

Si aucune correspondance n'est trouvée dans le CRM, un contact fictif est retourné afin que 3CX puisse tout de même déclencher l'étape de création d'appel.

POST /api/crm/lookup/contacts

Crée un nouveau contact dans le CRM connecté.

Corps de la requête

Réponse 201

{
  "response": "ok",
  "contact": { ... }
}

Réponse 400 — le connecteur CRM n'a pas pu créer le contact.

GET /api/crm/lookup/phone-calls

Retourne la liste des appels téléphoniques depuis le connecteur CRM connecté.

Paramètres de requête

Réponse 200 — liste paginée d'objets appel.

POST /api/crm/lookup/phone-calls

Enregistre un appel téléphonique terminé dans le CRM connecté. C'est l'endpoint principal appelé par le Middleware CRM lorsqu'un appel se termine sur le PBX.

Corps de la requête

*number_from et number_to sont mutuellement requis — fournissez les deux ou aucun.
**number_external et number_internal sont mutuellement requis — fournissez les deux ou aucun.

Réponse 201

{
  "response": "success",
  "message": "Call saved successfully.",
  "call": { ... }
}

Réponse 400 — la journalisation des appels n'est pas activée pour ce compte.

POST /api/crm/lookup/phone-calls/context

Crée ou met à jour un enregistrement de contexte d'appel pendant un appel en cours. Le contexte permet de pré-renseigner la fiche CRM afin qu'à la fin de l'appel, l'entrée complète puisse être enrichie sans dépendre uniquement du payload final.

Corps de la requête

Réponse 201

{
  "response": "success",
  "message": "Call context saved successfully.",
  "call_context_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Variante par token

Pour les cas où le Middleware CRM ne peut pas utiliser un token OAuth standard, un token de contexte pré-émis peut être utilisé à la place :

POST /api/crm/phone-calls-context/{token}/{tokenSecret}

Cet endpoint accepte le même corps de requête et ne nécessite pas d'en-tête Authorization. Le token (UUID) et le tokenSecret sont émis par CX-Engine et scopés à un client spécifique.

POST /api/crm/lookup/chats

Enregistre une session de chat terminée dans le CRM connecté. Appelé par le Middleware CRM lorsqu'une session de chat se termine sur le PBX.

Corps de la requête

Réponse 201

{
  "response": "success",
  "message": "Chat saved successfully.",
  "chat": { ... }
}

Réponse 400 — la journalisation des chats n'est pas activée pour ce compte.