Crear cliente

curl --request POST \
  --url https://gateway.jelou.ai/platform/v3/companies/clients \
  --header 'x-api-key: API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "names": "Ana Pérez",
    "botId": "BOT_ID",
    "phone": "+593991234567",
    "tags": [12]
  }'

{
  "message": [
    "Client has been created."
  ],
  "statusMessage": "success",
  "status": 1,
  "data": {
    "client": {
      "referenceId": "593991234567",
      "botId": "BOT_ID",
      "names": "Ana Pérez",
      "roomId": "G:BOT_ID:593991234567",
      "createdAt": "2026-11-05T21:00:38.548Z",
      "tags": [
        {
          "id": 12,
          "name": {
            "en": "",
            "es": "VIP"
          },
          "color": "#46bba4"
        }
      ]
    }
  }
}

{
  "status": "failed",
  "message": "Unauthorized"
}

{
  "data": {
    "missingScopes": [
      "clients:write"
    ]
  },
  "message": [
    "Your API key is not allowed to perform this action."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1410",
    "key": "API_KEY_SCOPE_MISSING",
    "description": "The API key used through the gateway does not grant the scope the route requires.",
    "developerMessages": {
      "es": "La API key no incluye el permiso requerido.",
      "en": "The API key does not include the required scope.",
      "pt": "A chave de API não inclui o escopo exigido."
    },
    "clientMessages": {
      "es": "Tu API key no tiene permiso para realizar esta acción.",
      "en": "Your API key is not allowed to perform this action.",
      "pt": "Sua chave de API não tem permissão para realizar esta ação."
    }
  }
}

{
  "message": [
    "The clients API is not available for your account yet."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1411",
    "key": "CLIENTS_API_NOT_ENABLED",
    "description": "The clients API is not enabled for the company yet (apps_clients_v2_phase3 is off).",
    "developerMessages": {
      "es": "La API de clientes no está habilitada para esta compañía.",
      "en": "The clients API is not enabled for this company.",
      "pt": "A API de clientes não está habilitada para esta empresa."
    },
    "clientMessages": {
      "es": "La API de clientes aún no está disponible para tu cuenta.",
      "en": "The clients API is not available for your account yet.",
      "pt": "A API de clientes ainda não está disponível para sua conta."
    }
  }
}

{
  "message": [
    "Clients cannot be created in this channel. Choose a WhatsApp channel in production."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1383",
    "key": "CLIENT_BOT_NOT_ELIGIBLE",
    "description": "Error thrown when the bot is not a production WhatsApp channel of the company linked to a project.",
    "developerMessages": {
      "es": "El bot no existe en la compañía o no es un canal de WhatsApp en producción con proyecto.",
      "en": "The bot does not belong to the company or is not a production WhatsApp channel with a project.",
      "pt": "O bot não pertence à empresa ou não é um canal de WhatsApp em produção com projeto."
    },
    "clientMessages": {
      "es": "El canal no permite crear clientes. Elige un canal de WhatsApp en producción.",
      "en": "Clients cannot be created in this channel. Choose a WhatsApp channel in production.",
      "pt": "Não é possível criar clientes neste canal. Escolha um canal de WhatsApp em produção."
    }
  }
}

{
  "data": {
    "client": {
      "referenceId": "593991234567",
      "botId": "BOT_ID",
      "names": "Ana Pérez",
      "roomId": "G:BOT_ID:593991234567",
      "createdAt": "2026-10-20T10:00:00.000Z",
      "tags": []
    }
  },
  "message": [
    "This client already exists."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1382",
    "key": "CLIENT_ALREADY_EXISTS",
    "description": "Error thrown when the phone is already a client of the bot.",
    "developerMessages": {
      "es": "El celular ya es un cliente de este canal.",
      "en": "The phone is already a client of this channel.",
      "pt": "O celular já é um cliente deste canal."
    },
    "clientMessages": {
      "es": "Este cliente ya existe.",
      "en": "This client already exists.",
      "pt": "Este cliente já existe."
    }
  }
}

{
  "message": [
    "This client is being created right now. Try again in a few seconds."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1386",
    "key": "CLIENT_CREATION_IN_PROGRESS",
    "description": "Error thrown when the same client is being created by another request.",
    "developerMessages": {
      "es": "Otra solicitud está creando este cliente.",
      "en": "Another request is creating this client.",
      "pt": "Outra solicitação está criando este cliente."
    },
    "clientMessages": {
      "es": "Este cliente se está creando en este momento. Intenta de nuevo en unos segundos.",
      "en": "This client is being created right now. Try again in a few seconds.",
      "pt": "Este cliente está sendo criado agora. Tente novamente em alguns segundos."
    }
  }
}

{
  "message": [
    "Los valores ingresados no son correctos."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E0422",
    "key": "VALIDATOR_ERROR",
    "description": "Error to be thrown when cannot process request because of incoming values",
    "developerMessages": {
      "es": "Los valores del request no son correctos para ser procesados.",
      "en": "The request values are not correct for processing.",
      "pt": "Os valores do request não estão corretos para serem processados."
    },
    "clientMessages": {
      "es": "Los valores ingresados no son correctos.",
      "en": "The values entered are not correct.",
      "pt": "Os valores inseridos não estão corretos."
    }
  },
  "validationError": {
    "names": [
      {
        "pt": "O campo names é obrigatório e deve ter no máximo 191 caracteres.",
        "es": "El campo names es obligatorio y debe tener máximo 191 caracteres.",
        "en": "The names field is required and must have at most 191 characters."
      }
    ]
  }
}

{
  "message": [
    "Enter the mobile number with the country code."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1384",
    "key": "CLIENT_INVALID_PHONE",
    "description": "Error thrown when the client phone is not a valid number with country code.",
    "developerMessages": {
      "es": "El celular no es un número válido con código de país.",
      "en": "The phone is not a valid number with country code.",
      "pt": "O celular não é um número válido com código do país."
    },
    "clientMessages": {
      "es": "Ingresa el celular con el código de país.",
      "en": "Enter the mobile number with the country code.",
      "pt": "Informe o celular com o código do país."
    }
  }
}

{
  "message": [
    "One or more tags do not exist."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1385",
    "key": "CLIENT_TAGS_NOT_FOUND",
    "description": "Error thrown when a tag does not exist or is inactive in the company.",
    "developerMessages": {
      "es": "Una o más etiquetas no existen o están inactivas en la compañía.",
      "en": "One or more tags do not exist or are inactive in the company.",
      "pt": "Uma ou mais etiquetas não existem ou estão inativas na empresa."
    },
    "clientMessages": {
      "es": "Una o más etiquetas no existen.",
      "en": "One or more tags do not exist.",
      "pt": "Uma ou mais etiquetas não existem."
    }
  }
}

{
  "message": [
    "You have exceeded the request limit. Please try again later."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E1110",
    "key": "TOO_MANY_REQUESTS",
    "description": "Rate limit exceeded. Too many requests in a short period.",
    "developerMessages": {
      "es": "Ha excedido el límite de solicitudes. Por favor, intente de nuevo más tarde.",
      "en": "You have exceeded the request limit. Please try again later.",
      "pt": "Você excedeu o limite de solicitações. Por favor, tente novamente mais tarde."
    },
    "clientMessages": {
      "es": "Ha excedido el límite de solicitudes. Por favor, intente de nuevo más tarde.",
      "en": "You have exceeded the request limit. Please try again later.",
      "pt": "Você excedeu o limite de solicitações. Por favor, tente novamente mais tarde."
    }
  }
}

{
  "message": [
    "We are having trouble processing your request. Please try again later."
  ],
  "statusMessage": "failed",
  "status": 0,
  "error": {
    "code": "E0000",
    "key": "UNKNOWN_ERROR",
    "description": "Error to be thrown when it couldn't be determined the reason of failure",
    "developerMessages": {
      "es": "Error inesperado occurido, revisar logs.",
      "en": "Unexpected error occurred, check logs."
    },
    "clientMessages": {
      "es": "Estamos teniendo problemas procesando la solicitud. Por favor intenta mas tarde.",
      "en": "We are having trouble processing your request. Please try again later."
    }
  }
}