Obtener integración

Get Integration

curl --request GET \
  --url https://gateway.jelou.ai/platform/v1/external-support/{projectId} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://gateway.jelou.ai/platform/v1/external-support/{projectId}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://gateway.jelou.ai/platform/v1/external-support/{projectId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gateway.jelou.ai/platform/v1/external-support/{projectId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gateway.jelou.ai/platform/v1/external-support/{projectId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://gateway.jelou.ai/platform/v1/external-support/{projectId}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://gateway.jelou.ai/platform/v1/external-support/{projectId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "INTEGRATION_ID",
  "brainId": "BRAIN_ID",
  "webhookUrl": "https://my-system.com/webhook/jelou",
  "authType": "bearer",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

GET

external-support

{projectId}

Get Integration

curl --request GET \
  --url https://gateway.jelou.ai/platform/v1/external-support/{projectId} \
  --header 'x-api-key: <api-key>'

import requests

url = "https://gateway.jelou.ai/platform/v1/external-support/{projectId}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://gateway.jelou.ai/platform/v1/external-support/{projectId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gateway.jelou.ai/platform/v1/external-support/{projectId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gateway.jelou.ai/platform/v1/external-support/{projectId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://gateway.jelou.ai/platform/v1/external-support/{projectId}")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://gateway.jelou.ai/platform/v1/external-support/{projectId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "id": "INTEGRATION_ID",
  "brainId": "BRAIN_ID",
  "webhookUrl": "https://my-system.com/webhook/jelou",
  "authType": "bearer",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

{
  "message": "<string>",
  "statusMessage": "<string>",
  "status": 123,
  "error": {
    "code": "<string>",
    "key": "<string>",
    "description": "<string>",
    "developerMessages": {},
    "clientMessages": {}
  },
  "validationError": {}
}

Descripción

Consulta la configuración actual de la integración asociada a un proyecto de Jelou. Es útil para verificar el estado de la integración, confirmar la URL del webhook activa o auditar los cambios realizados sin necesidad de modificar la configuración.

Endpoint

GET https://gateway.jelou.ai/platform/v1/external-support/{projectId}

Parámetros de ruta

string

requerido

Identificador único del proyecto de Jelou cuya integración se desea consultar.

Autenticación

Todas las peticiones deben incluir el encabezado x-api-key con la API key del proyecto de Jelou.

x-api-key: API_KEY

Ejemplo de solicitud

El siguiente ejemplo consulta la integración configurada para el proyecto PROJECT_ID:

cURL

curl --request GET \
  --url https://gateway.jelou.ai/platform/v1/external-support/PROJECT_ID \
  --header 'x-api-key: API_KEY'

Respuestas

Código	Estado	Descripción
200	OK	Integración encontrada. Devuelve la configuración actual.
401	Unauthorized	Credenciales de autenticación inválidas o faltantes.
404	Not Found	No existe una integración para el `projectId` indicado.
500	Internal Server Error	Error interno del servidor.

Ejemplo de respuesta

{
  "message": [
    "Integration retrieved successfully"
  ],
  "statusMessage": "success",
  "status": 1,
  "data": {
    "brainId": "PROJECT_ID",
    "webhookUrl": "https://mi-sistema.com/webhook/jelou",
    "createdAt": "2026-01-15T10:30:00.000Z",
    "updatedAt": "2026-01-20T14:45:00.000Z"
  }
}

Estructura de la respuesta

Propiedad	Tipo	Descripción
brainId	string	Identificador único del proyecto de Jelou.
webhookUrl	string	URL del endpoint que recibe los eventos de Jelou.
createdAt	date	Fecha y hora de creación de la integración.
updatedAt	date	Fecha y hora de la última actualización.

Autorizaciones

x-api-key

string

header

requerido

API key del proyecto de Jelou

Parámetros de ruta

projectId

string

requerido

Unique identifier of the Jelou project

Respuesta

Integration retrieved successfully

string

Ejemplo:

"INTEGRATION_ID"

brainId

string

Ejemplo:

"BRAIN_ID"

webhookUrl

string

Ejemplo:

"https://my-system.com/webhook/jelou"

authType

string

Ejemplo:

"bearer"

createdAt

string<date-time>

updatedAt

string<date-time>

Crear integración

Actualizar integración

⌘I

API reference

Envío de mensajes

Campañas

Conversaciones

Métricas

Usuarios

Recursos

Widget

Datum

Panel de Atención Externo

Gestión de Memoria

Descripción

Endpoint

Parámetros de ruta

Autenticación

Ejemplo de solicitud

Respuestas

Ejemplo de respuesta

Estructura de la respuesta

Autorizaciones

Parámetros de ruta

Respuesta

​Descripción

​Endpoint

​Parámetros de ruta

​Autenticación

​Ejemplo de solicitud

​Respuestas

​Ejemplo de respuesta

​Estructura de la respuesta

Autorizaciones

Parámetros de ruta

Respuesta

Descripción

Endpoint

Parámetros de ruta

Autenticación

Ejemplo de solicitud

Respuestas

Ejemplo de respuesta

Estructura de la respuesta