Assign Appointment to Operator_External
Assign Appointment to Operator_External
# Assign Appointment to Operator (External ID Variant) (`assignCouncilToUser`)
Este método permite asignar una cita (consejo) existente a un operador utilizando el identificador externo del usuario (`userExternalId`) y el identificador externo de la organización o entidad (`companyExternalId`). Esta variante es ideal para integraciones con CRMs o sistemas legados del cliente, ya que permite realizar la asignación sin necesidad de conocer los identificadores numéricos internos de la base de datos de OVAC.
### Autenticación
> **Tipo:** API Key**
Header:** `x-jwt-token`
**Ubicación:** Header HTTP_
Ejemplo:_ `x-jwt-token: eyJhbGciOiJIUzI1NiIsInR5cCI6...`
## Referencia de la API
### Parámetros de Entrada (Variables)
| Parámetro | Descripción | Requerido | Tipo |
| --- | --- | --- | --- |
| councilId | Identificador numérico único de la cita en la plataforma. | SI | Integer |
| userExternalId | Identificador único del usuario en el sistema de origen del cliente. | SI | String |
| companyExternalId | Identificador único de la entidad u organización en el sistema de origen del cliente. | SI | String |
### Campos de Respuesta (Payload)
La mutación devuelve un objeto `assignCouncilToUser` con el resultado de la asignación de personal:
| Parámetro | Descripción | Tipo |
| --- | --- | --- |
| data | Objeto dato | Object |
| data.assignCouncilToUser | Objeto del usuario | Object |
| data.assignCouncilToUser.success | Valor booleano de verificación de asignación. | Boolean |
| data.assignCouncilToUser.message | Error que devuelve, por defecto _null_ | String |
## Ejemplos de Código y Peticiones
### 1\. Mutación GraphQL
``` graphql
mutation AssignCouncilToUser(
$councilId: Int!,
$userId: Int,
$userExternalId: String,
$companyExternalId: String
) {
assignCouncilToUser(
councilId: $councilId,
userId: $userId,
userExternalId: $userExternalId,
companyExternalId: $companyExternalId
) {
success
message
}
}
```
### 2\. Variables de la Petición (JSON Payload)
``` json
{
"councilId": 64886,
"userExternalId": "TEST001",
"companyExternalId": "API_TEST"
}
```
### 3\. Ejemplo de comando cURL
``` bash
curl --location "https://api.ovac.pre.councilbox.com/graphql" \
--header "Content-Type: application/json" \
--header "x-jwt-token: {{token}}" \
--data '{"query":"mutation AssignCouncilToUser($councilId: Int!, $userId: Int, $userExternalId: String, $companyExternalId: String) { assignCouncilToUser(councilId: $councilId, userId: $userId, userExternalId: $userExternalId, companyExternalId: $companyExternalId) { success message } }","variables":{"councilId":64886,"userExternalId":"TEST001","companyExternalId":"API_TEST"}}'
```
### 4\. Respuesta Esperada (200 OK)
``` json
{
"data": {
"assignCouncilToUser": {
"success": true,
"message": null
}
}
}
```
> **Nota OpenAPI/Fern:** esta operación GraphQL se documenta como `/graphql/assigncounciltouser-2` para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es `POST /graphql`.