Affecter un appel à un technicien

curl --request POST \
--url https://api.arquos.eu/api/v2/calls/ID_DE_L_OBJET/assign \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON' \
--header 'Content-Type: application/json' \
--data '{
"technicianId": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192"
}'

{
"id": "e8afaf6a-edae-4843-b37d-1833931864b8",
"ok": true,
"link": "/calls/e8afaf6a-edae-4843-b37d-1833931864b8",
"url": "https://app.arquos.eu/calls/e8afaf6a-edae-4843-b37d-1833931864b8"
}

curl --request POST \
--url https://api.arquos.eu/api/v2/calls/ID_DE_L_OBJET/assign \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON' \
--header 'Content-Type: application/json' \
--data '{
"technicianId": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192"
}'

{
"id": "e8afaf6a-edae-4843-b37d-1833931864b8",
"ok": true,
"link": "/calls/e8afaf6a-edae-4843-b37d-1833931864b8",
"url": "https://app.arquos.eu/calls/e8afaf6a-edae-4843-b37d-1833931864b8"
}

Endpoint & Authentification

Méthode	URL
`POST`	`https://api.arquos.eu/api/v2/calls/{id}/assign`

En-têtes (Headers) :

Authorization: Bearer [VOTRE_JETON_D_API]
X-Arquos-Agency: [IDENTIFIANT_D_AGENCE] (facultatif, voir Agence)
Content-Type: application/json

Paramètres de la requête

string

required

L’identifiant de l’objet.

string

L’identifiant de l’agence où agir. Absent : l’agence par défaut du compte. Une agence hors de sa portée est refusée (403).

string

required

string

Le nom du technicien, pour la confirmation.

Réponse (`201`)

string

L’identifiant de l’appel affecté.

boolean

Toujours true : un refus rend un code d’erreur et sa raison.

string

Le chemin de la fiche dans Arquos.

string

L’adresse complète de la fiche, à ouvrir dans un navigateur.

Les erreurs

Code	Quand
`400`	Requête mal formée ou champ obligatoire manquant.
`401`	Jeton absent, inconnu ou révoqué.
`403`	Agence hors de votre portée.
`404`	Objet introuvable dans vos agences.
`422`	Saisie refusée par Arquos (champ obligatoire, valeur hors bornes, choix inconnu).
`429`	Trop d’appels : réessayez après le délai de l’en-tête Retry-After.

Le corps d’une erreur porte error, sa raison en français. Voir Les erreurs.

curl --request POST \
--url https://api.arquos.eu/api/v2/calls/ID_DE_L_OBJET/assign \
--header 'Authorization: Bearer arq_agent_VOTRE_JETON' \
--header 'Content-Type: application/json' \
--data '{
"technicianId": "3f1c2b9e-8a4d-4c1e-9b7a-2d5e6f708192"
}'

{
"id": "e8afaf6a-edae-4843-b37d-1833931864b8",
"ok": true,
"link": "/calls/e8afaf6a-edae-4843-b37d-1833931864b8",
"url": "https://app.arquos.eu/calls/e8afaf6a-edae-4843-b37d-1833931864b8"
}

Démarrer

API REST

Centres d'appels

Agents IA

Référence · Compte

Référence · Recherche

Référence · Équipements

Référence · Relevés

Référence · Contrats

Référence · Import

Référence · Webhooks

Référence · Référentiels

Référence · Affaires

Référence · Appels

Référence · Visites

Référence · Techniciens

Référence · Pièces

Référence · Devis

Référence · Notes

Référence · Écarts et réserves

Référence · Factures

Référence · Clients

Référence · Immeubles

Référence · Contacts

Référence · Secteurs

Référence · Campagnes

Référence · Contrôles techniques

Référence · Sollicitations

Endpoint & Authentification

Paramètres de la requête

Réponse (`201`)

Les erreurs

​Endpoint & Authentification

​Paramètres de la requête

​Réponse (201)

​Les erreurs

Endpoint & Authentification

Paramètres de la requête

Réponse (`201`)

Les erreurs