Obtener información de una conversación
curl --request GET \
--url https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot \
--header 'apikey: <apikey>'import requests
url = "https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot"
headers = {"apikey": "<apikey>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {apikey: '<apikey>'}};
fetch('https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot', 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://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"apikey: <apikey>"
],
]);
$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://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("apikey", "<apikey>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot")
.header("apikey", "<apikey>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["apikey"] = '<apikey>'
response = http.request(request)
puts response.read_bodyEndpoints principales
Obtener información de una conversación
Recupera el contexto y el resumen de una conversación de Inagent para transferir la gestión a un agente humano.
GET
/
engine
/
api
/
administration
/
session
/
{sessionId}
/
snapshot
Obtener información de una conversación
curl --request GET \
--url https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot \
--header 'apikey: <apikey>'import requests
url = "https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot"
headers = {"apikey": "<apikey>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {apikey: '<apikey>'}};
fetch('https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot', 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://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"apikey: <apikey>"
],
]);
$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://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("apikey", "<apikey>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot")
.header("apikey", "<apikey>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["apikey"] = '<apikey>'
response = http.request(request)
puts response.read_bodyObtiene el estado de una conversación de Inagent, incluido su contexto, a partir del identificador de sesión.
Este endpoint se utiliza durante la transferencia desde un agente virtual de Inagent hacia un agente humano. Permite que el sistema de destino recupere lo ocurrido durante la gestión automática y presente esa información al agente humano antes de que continúe la atención.
Flujo de transferencia
- El agente virtual inicia la transferencia hacia el agente humano.
- Inagent envía el
sessionIden la cabecera SIPX-Session-IDde la llamada. - El sistema que recibe la transferencia extrae el
sessionIddeX-Session-ID. - El backend del sistema de destino consulta el snapshot de la sesión.
- La interfaz del agente humano muestra el contexto o el resumen de la conversación.
La cabecera SIP que contiene el identificador de la sesión es siempre
X-Session-ID. Utiliza su valor como parámetro de ruta en este endpoint.Cabecera SIP
X-Session-ID: <sessionId>
Endpoint
GET /engine/api/administration/session/{sessionId}/snapshot
Autenticación
string
required
API Key proporcionada para la integración.
Parámetros de ruta
string
required
Identificador de la sesión de Inagent, obtenido de la cabecera SIP
X-Session-ID recibida durante la transferencia.Ejemplos
curl --request GET \
--url "https://api.backend.inconcertcc.com/engine/api/administration/session/{sessionId}/snapshot" \
--header "apikey: tu-api-key-aqui"
const sessionId = "session-id-obtenido-desde-sip";
const response = await fetch(
`https://api.backend.inconcertcc.com/engine/api/administration/session/${encodeURIComponent(sessionId)}/snapshot`,
{
method: "GET",
headers: {
apikey: process.env.INCONCERT_API_KEY
}
}
);
if (!response.ok) {
throw new Error(`Error obteniendo el snapshot: ${response.status}`);
}
const payload = await response.json();
const context = payload.data.snapshot.configuration.context;
const conversationSummary = context.ResumenConversacion;
import os
import requests
session_id = "session-id-obtenido-desde-sip"
url = (
"https://api.backend.inconcertcc.com/engine/api/administration/"
f"session/{session_id}/snapshot"
)
response = requests.get(
url,
headers={"apikey": os.environ["INCONCERT_API_KEY"]},
timeout=10
)
response.raise_for_status()
payload = response.json()
context = payload["data"]["snapshot"]["configuration"]["context"]
conversation_summary = context["ResumenConversacion"]
Acceso a los datos
La respuesta devuelve el snapshot de la sesión. Utiliza las siguientes rutas para acceder a la información necesaria:| Información | Ruta en la respuesta |
|---|---|
| Contexto completo | data.snapshot.configuration.context |
| Resumen de la conversación | data.snapshot.configuration.context.ResumenConversacion |
Muestra el resumen al agente humano antes de que atienda la transferencia y conserva el contexto completo para consultar detalles adicionales de la gestión.
Realiza la petición desde un backend seguro. No expongas la API Key en aplicaciones cliente ni en la interfaz del agente.
Was this page helpful?

