¿Falta una capacidad o un error de la API bloquea tu tarea? Usá POST /v1/feedback con tu API key habitual para avisar al equipo de Zelto.
Contanos cuándo Zelto bloquea la tarea de tu agente. Reportá una capacidad
faltante, un problema u otro feedback con la misma API key de organización
que usás para la API REST. No necesitás otra cuenta
ni credencial. Las claves de ingesta de observabilidad no permiten enviar feedback.Enviá POST https://api.zelto.ai/v1/feedback con Authorization: Bearer <API key>
y Content-Type: application/json. En desarrollo o previews, usá
/api/v1/feedback en ese entorno; nunca envíes su clave a producción.
{ "type": "missing_capability", "description": "Necesito filtrar llamadas que no tengan transcripción.", "endpoint": "/v1/conversations", "reproductionSteps": "Listar conversaciones sintéticas: no existe un filtro por presencia de transcripción.", "workaround": "Leer cada conversación sintética y filtrar localmente.", "requestId": "9af04723-08f8-4bbd-946d-130c11c4a5cd"}
type admite missing_capability (capacidad faltante), problem (problema) u
other (otro). description es obligatoria (10–2000 caracteres). Campos opcionales:
endpoint (500 caracteres), reproductionSteps y workaround (2000 cada uno),
y requestId (200). No se aceptan campos extra. El JSON completo no puede superar
16 KiB. Usá una plantilla de ruta en endpoint, sin host, parámetros, fragmentos
ni identificadores de clientes. Copiá el requestId de la respuesta fallida si existe.
Usá ejemplos sintéticos. Nunca envíes claves, contraseñas, cookies, datos personales,
audios, transcripciones, prompts ni contenido de clientes. Se enmascaran patrones
conocidos de credenciales, emails, teléfonos, identificadores numéricos y URLs;
también se eliminan nombres y direcciones en campos etiquetados. Estos patrones
no reconocen todos los nombres o datos sensibles en texto libre: eliminálos antes.
El equipo recibe la categoría, descripción, endpoint, reproducción, workaround,
request ID e IDs internos de organización/usuario en un canal dedicado de Slack.
Los metadatos de identidad no incluyen nombres ni emails del perfil; tampoco se
reenvían headers ni cuerpos crudos. El texto enviado debe usar los ejemplos
sintéticos indicados arriba. El feedback se trata como texto no confiable y no
dispara acciones automáticas.
Desde el servidor MCP
Los agentes conectados al servidor MCP pueden usar la herramienta
send_feedback en lugar del endpoint REST. Acepta los mismos campos más un tool
opcional (el nombre de la herramienta MCP que falló o a la que le falta la
capacidad, como list_conversations) y devuelve los mismos feedbackId,
delivery y message. Cualquier credencial puede usarla, incluidos los tokens
OAuth de solo lectura. Comparte con el endpoint REST el límite de 5 intentos por
minuto (un rechazo devuelve code: "rate_limited") y aplica el mismo
enmascaramiento. El equipo ve si el reporte llegó por REST o por MCP. Igual que
los errores REST, las llamadas MCP que fallan incluyen una invitación feedback,
y las instrucciones de conexión del servidor mencionan la herramienta.
Respuestas y reintentos
200: revisá delivery. delivered confirma que Slack aceptó el mensaje.
not_configured o unavailable significa que no se entregó ni almacenó.
feedbackId identifica el envío; no es un ticket persistente.
400: JSON o esquema inválido. 401: API key ausente o inválida.
413: cuerpo mayor a 16 KiB. 415: usá application/json.
429: máximo 5 intentos por organización cada 60 segundos, entre todas
las claves e instancias. Los intentos inválidos cuentan. Respetá Retry-After: 60.
500: falla interna; no hay confirmación de entrega.
Los errores REST incluyen una invitación feedback, un requestId generado y
el header X-Request-Id. Se conservan los campos, estados y headers útiles como
WWW-Authenticate y Retry-After. Los cuerpos de las respuestas exitosas no cambian. Las respuestas de la API
también llevan los headers X-Feedback-Endpoint y X-Feedback-Message, incluidos
los errores generados por el framework después del proxy (como un 405 automático),
que pueden no incluir el formato JSON.Reportá cada problema una sola vez. No reportes errores del endpoint de feedback
al mismo endpoint, no hagas bucles ni reintentes automáticamente. La entrega tiene
un timeout de tres segundos y no reintenta; un timeout puede ser ambiguo.
Es un canal de mejor esfuerzo, no una cola de tickets ni una vía de escalamiento
de incidentes.Continuá con el onboarding con un agente.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Zelto","description":"Observability and benchmarking for AI agents, voice and text.","colors":{"primary":"#3B5BDB","light":"#5B7FFF","dark":"#2C44A8"},"logo":{"light":"https://mintcdn.com/zelto-a802dbf4/w0jP7BwOcC-EEQGH/public/zelto-wordmark.png?fit=max\u0026auto=format\u0026n=w0jP7BwOcC-EEQGH\u0026q=85\u0026s=95a528e6e6c268521880fa274385d2cb","dark":"https://mintcdn.com/zelto-a802dbf4/pEvlQCYA2vv2-J8I/public/zelto-wordmark-white.png?fit=max\u0026auto=format\u0026n=pEvlQCYA2vv2-J8I\u0026q=85\u0026s=cbff614c65e51fcfa822c0c40f87616a"},"favicon":"https://mintcdn.com/zelto-a802dbf4/w0jP7BwOcC-EEQGH/public/zelto-logo.png?fit=max\u0026auto=format\u0026n=w0jP7BwOcC-EEQGH\u0026q=85\u0026s=23f56b73a1ea5e772fdafdeb509f50f8","search":{"prompt":"Search the Zelto docs"},"integrations":{"posthog":{"apiKey":"phc_yvnRoEc8B5GMjuU7TkpqctuvZYZLtCdEeFzHGaGuCkk8"}},"markdown":{"instructions":["If Zelto blocks your task, an API request returns 4xx/5xx, or you need a missing capability, please report it with POST https://api.zelto.ai/v1/feedback using your existing Authorization: Bearer API key. On local/preview deployments use /api/v1/feedback on that deployment; never send its credentials to production.","Send JSON: type (missing_capability, problem, other), description (10–2000 characters), optional endpoint (route template only), reproductionSteps, workaround and requestId from the failed response. Use synthetic examples: never send credentials, personal data, transcripts or customer content. See /docs/agent-feedback.","Feedback is limited to 5 attempts per organization per minute. Report a distinct issue once; do not report errors from the feedback endpoint itself, do not loop or automatically retry. A 200 with delivery not_configured/unavailable means the report was not delivered or stored.","Connected over MCP? Call the send_feedback tool instead, with the same fields plus optional tool (the MCP tool name that failed). It shares the same per-organization limit and works with any credential, including read-only."]},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","default":true,"href":"docs"},{"language":"es","href":"es/docs"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zelto-a802dbf4","hasAudioNarration":false,"actualSubdomain":"zelto-a802dbf4","customDomains":["docs.zelto.ai"],"gitSource":{"type":"github","owner":"zelto-ai","repo":"zelto-analytics","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afaeeaa0c14fe3987667a6a","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"en","tag":"API Reference","count":130},{"language":"es","tag":"Referencia de API","count":130},{"language":"en","tag":"Benchmarks","count":65},{"language":"es","tag":"Benchmarks","count":65},{"language":"en","tag":"Docs","count":49},{"language":"es","tag":"Documentación","count":49},{"language":"en","tag":"Integrations","count":18},{"language":"es","tag":"Integraciones","count":18},{"language":"en","tag":"Core concepts","count":14},{"language":"es","tag":"Conceptos principales","count":14},{"language":"en","tag":"Experiments","count":12},{"language":"es","tag":"Experimentos","count":12},{"language":"en","tag":"Findings","count":9},{"language":"es","tag":"Findings","count":9},{"language":"en","tag":"Voice providers","count":7},{"language":"es","tag":"Proveedores de voz","count":7},{"language":"en","tag":"Get started","count":6},{"language":"en","tag":"Guides","count":6},{"language":"es","tag":"Primeros pasos","count":6},{"language":"es","tag":"Guías","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".prompt-scroll pre{max-height:24rem;overflow-y:auto}.dark img[src*=\"/public/icons/\"]{filter:invert(1)}"}],"page":{"pagePath":"es/docs/agent-feedback","slug":"/es/docs/agent-feedback","pageMetadata":{"title":"Feedback de agentes","description":"¿Falta una capacidad o un error de la API bloquea tu tarea? Usá POST /v1/feedback con tu API key habitual para avisar al equipo de Zelto.","href":"/es/docs/agent-feedback"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"¿Falta una capacidad o un error de la API bloquea tu tarea? Usá POST /v1/feedback con tu API key habitual para avisar al equipo de Zelto.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Contanos cuándo Zelto bloquea la tarea de tu agente. Reportá una `,_jsx(_components.strong,{children:`capacidad\nfaltante`}),`, un `,_jsx(_components.strong,{children:`problema`}),` u `,_jsx(_components.strong,{children:`otro feedback`}),` con la misma API key de organización\nque usás para la `,_jsx(_components.a,{href:`/es/docs/integrations/index`,children:`API REST`}),`. No necesitás otra cuenta\nni credencial. Las claves de ingesta de observabilidad no permiten enviar feedback.`]}),`\n`,_jsxs(_components.p,{children:[`Enviá `,_jsx(_components.code,{children:`POST https://api.zelto.ai/v1/feedback`}),` con `,_jsx(_components.code,{children:`Authorization: Bearer \u003cAPI key>`}),`\ny `,_jsx(_components.code,{children:`Content-Type: application/json`}),`. En desarrollo o previews, usá\n`,_jsx(_components.code,{children:`/api/v1/feedback`}),` en ese entorno; nunca envíes su clave a producción.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"missing_capability\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Necesito filtrar llamadas que no tengan transcripción.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"endpoint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/v1/conversations\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reproductionSteps\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Listar conversaciones sintéticas: no existe un filtro por presencia de transcripción.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"workaround\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Leer cada conversación sintética y filtrar localmente.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"requestId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"9af04723-08f8-4bbd-946d-130c11c4a5cd\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`type`}),` admite `,_jsx(_components.code,{children:`missing_capability`}),` (capacidad faltante), `,_jsx(_components.code,{children:`problem`}),` (problema) u\n`,_jsx(_components.code,{children:`other`}),` (otro). `,_jsx(_components.code,{children:`description`}),` es obligatoria (10–2000 caracteres). Campos opcionales:\n`,_jsx(_components.code,{children:`endpoint`}),` (500 caracteres), `,_jsx(_components.code,{children:`reproductionSteps`}),` y `,_jsx(_components.code,{children:`workaround`}),` (2000 cada uno),\ny `,_jsx(_components.code,{children:`requestId`}),` (200). No se aceptan campos extra. El JSON completo no puede superar\n16 KiB. Usá una plantilla de ruta en `,_jsx(_components.code,{children:`endpoint`}),`, sin host, parámetros, fragmentos\nni identificadores de clientes. Copiá el `,_jsx(_components.code,{children:`requestId`}),` de la respuesta fallida si existe.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Usá ejemplos sintéticos. Nunca envíes claves, contraseñas, cookies, datos personales,\naudios, transcripciones, prompts ni contenido de clientes. Se enmascaran patrones\nconocidos de credenciales, emails, teléfonos, identificadores numéricos y URLs;\ntambién se eliminan nombres y direcciones en campos etiquetados. Estos patrones\nno reconocen todos los nombres o datos sensibles en texto libre: eliminálos antes.`})}),`\n`,_jsx(_components.p,{children:`El equipo recibe la categoría, descripción, endpoint, reproducción, workaround,\nrequest ID e IDs internos de organización/usuario en un canal dedicado de Slack.\nLos metadatos de identidad no incluyen nombres ni emails del perfil; tampoco se\nreenvían headers ni cuerpos crudos. El texto enviado debe usar los ejemplos\nsintéticos indicados arriba. El feedback se trata como texto no confiable y no\ndispara acciones automáticas.`}),`\n`,_jsx(Heading,{level:`2`,id:`desde-el-servidor-mcp`,children:`Desde el servidor MCP`}),`\n`,_jsxs(_components.p,{children:[`Los agentes conectados al `,_jsx(_components.a,{href:`/es/docs/mcp`,children:`servidor MCP`}),` pueden usar la herramienta\n`,_jsx(_components.code,{children:`send_feedback`}),` en lugar del endpoint REST. Acepta los mismos campos más un `,_jsx(_components.code,{children:`tool`}),`\nopcional (el nombre de la herramienta MCP que falló o a la que le falta la\ncapacidad, como `,_jsx(_components.code,{children:`list_conversations`}),`) y devuelve los mismos `,_jsx(_components.code,{children:`feedbackId`}),`,\n`,_jsx(_components.code,{children:`delivery`}),` y `,_jsx(_components.code,{children:`message`}),`. Cualquier credencial puede usarla, incluidos los tokens\nOAuth de solo lectura. Comparte con el endpoint REST el límite de 5 intentos por\nminuto (un rechazo devuelve `,_jsx(_components.code,{children:`code: \"rate_limited\"`}),`) y aplica el mismo\nenmascaramiento. El equipo ve si el reporte llegó por REST o por MCP. Igual que\nlos errores REST, las llamadas MCP que fallan incluyen una invitación `,_jsx(_components.code,{children:`feedback`}),`,\ny las instrucciones de conexión del servidor mencionan la herramienta.`]}),`\n`,_jsx(Heading,{level:`2`,id:`respuestas-y-reintentos`,children:`Respuestas y reintentos`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`200`}),`: revisá `,_jsx(_components.code,{children:`delivery`}),`. `,_jsx(_components.code,{children:`delivered`}),` confirma que Slack aceptó el mensaje.\n`,_jsx(_components.code,{children:`not_configured`}),` o `,_jsx(_components.code,{children:`unavailable`}),` significa que `,_jsx(_components.strong,{children:`no se entregó ni almacenó`}),`.\n`,_jsx(_components.code,{children:`feedbackId`}),` identifica el envío; no es un ticket persistente.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`400`}),`: JSON o esquema inválido. `,_jsx(_components.code,{children:`401`}),`: API key ausente o inválida.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`413`}),`: cuerpo mayor a 16 KiB. `,_jsx(_components.code,{children:`415`}),`: usá `,_jsx(_components.code,{children:`application/json`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`429`}),`: máximo `,_jsx(_components.strong,{children:`5 intentos por organización cada 60 segundos`}),`, entre todas\nlas claves e instancias. Los intentos inválidos cuentan. Respetá `,_jsx(_components.code,{children:`Retry-After: 60`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500`}),`: falla interna; no hay confirmación de entrega.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Los errores REST incluyen una invitación `,_jsx(_components.code,{children:`feedback`}),`, un `,_jsx(_components.code,{children:`requestId`}),` generado y\nel header `,_jsx(_components.code,{children:`X-Request-Id`}),`. Se conservan los campos, estados y headers útiles como\n`,_jsx(_components.code,{children:`WWW-Authenticate`}),` y `,_jsx(_components.code,{children:`Retry-After`}),`. Los cuerpos de las respuestas exitosas no cambian. Las respuestas de la API\ntambién llevan los headers `,_jsx(_components.code,{children:`X-Feedback-Endpoint`}),` y `,_jsx(_components.code,{children:`X-Feedback-Message`}),`, incluidos\nlos errores generados por el framework después del proxy (como un 405 automático),\nque pueden no incluir el formato JSON.`]}),`\n`,_jsx(_components.p,{children:`Reportá cada problema una sola vez. No reportes errores del endpoint de feedback\nal mismo endpoint, no hagas bucles ni reintentes automáticamente. La entrega tiene\nun timeout de tres segundos y no reintenta; un timeout puede ser ambiguo.\nEs un canal de mejor esfuerzo, no una cola de tickets ni una vía de escalamiento\nde incidentes.`}),`\n`,_jsxs(_components.p,{children:[`Continuá con el `,_jsx(_components.a,{href:`/es/docs/onboarding-with-an-agent`,children:`onboarding con un agente`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Feedback de agentes","description":"¿Falta una capacidad o un error de la API bloquea tu tarea? Usá POST /v1/feedback con tu API key habitual para avisar al equipo de Zelto.","href":"/es/docs/agent-feedback"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Desde el servidor MCP","slug":"desde-el-servidor-mcp","depth":2,"children":[]},{"title":"Respuestas y reintentos","slug":"respuestas-y-reintentos","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"zelto-a802dbf4","siteName":"Zelto","title":"Feedback de agentes - Zelto","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/docs/agent-feedback","matchLevel":1},"es":{"href":"/es/docs/agent-feedback","matchLevel":0}}},"lastModified":"2026-11-10T20:53:32.676Z","originalFileLocation":"es/docs/agent-feedback.mdx","locale":"es"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"¿Falta una capacidad o un error de la API bloquea tu tarea? Usá POST /v1/feedback con tu API key habitual para avisar al equipo de Zelto.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zelto\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Feedback de agentes - Zelto\">\u003cmeta data-mint-head property=\"og:description\" content=\"¿Falta una capacidad o un error de la API bloquea tu tarea? Usá POST /v1/feedback con tu API key habitual para avisar al equipo de Zelto.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zelto\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.zelto.ai/es/docs/agent-feedback\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zelto-a802dbf4.mintlify.site/_mintlify/api/og/v2?division=Primeros+pasos\u0026amp;title=Feedback+de+agentes\u0026amp;description=%C2%BFFalta+una+capacidad+o+un+error+de+la+API+bloquea+tu+tarea%3F+Us%C3%A1+POST+%2Fv1%2Ffeedback+con+tu+API+key+habitual+para+avisar+al+equipo+de+Zelto.\u0026amp;theme=455839e89afb1494f2928eb8\u0026amp;signature=69fa0a5f9c11ab139ea3bc331e3b53a94ddbd6cdee223a7a6da0b533f9949f81\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Feedback de agentes - Zelto\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"¿Falta una capacidad o un error de la API bloquea tu tarea? Usá POST /v1/feedback con tu API key habitual para avisar al equipo de Zelto.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zelto-a802dbf4.mintlify.site/_mintlify/api/og/v2?division=Primeros+pasos\u0026amp;title=Feedback+de+agentes\u0026amp;description=%C2%BFFalta+una+capacidad+o+un+error+de+la+API+bloquea+tu+tarea%3F+Us%C3%A1+POST+%2Fv1%2Ffeedback+con+tu+API+key+habitual+para+avisar+al+equipo+de+Zelto.\u0026amp;theme=455839e89afb1494f2928eb8\u0026amp;signature=69fa0a5f9c11ab139ea3bc331e3b53a94ddbd6cdee223a7a6da0b533f9949f81\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zelto\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B5BDB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.zelto.ai/es/docs/agent-feedback\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/docs/agent-feedback.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.zelto.ai/es/docs/agent-feedback\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.zelto.ai/docs/agent-feedback\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.zelto.ai/docs/agent-feedback\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.zelto.ai/#organization\",\"name\":\"Zelto\",\"url\":\"https://docs.zelto.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zelto-a802dbf4/w0jP7BwOcC-EEQGH/public/zelto-wordmark.png?fit=max\u0026auto=format\u0026n=w0jP7BwOcC-EEQGH\u0026q=85\u0026s=95a528e6e6c268521880fa274385d2cb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.zelto.ai#website\",\"name\":\"Zelto\",\"url\":\"https://docs.zelto.ai\",\"publisher\":{\"@id\":\"https://docs.zelto.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.zelto.ai/es/docs/agent-feedback#webpage\",\"url\":\"https://docs.zelto.ai/es/docs/agent-feedback\",\"name\":\"Feedback de agentes\",\"description\":\"¿Falta una capacidad o un error de la API bloquea tu tarea? Usá POST /v1/feedback con tu API key habitual para avisar al equipo de Zelto.\",\"dateModified\":\"2026-11-10T20:53:32.676Z\",\"isPartOf\":{\"@id\":\"https://docs.zelto.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.zelto.ai/es/docs/agent-feedback#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.zelto.ai/es/docs/agent-feedback#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Primeros pasos\",\"item\":\"https://docs.zelto.ai/es/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Feedback de agentes\",\"item\":\"https://docs.zelto.ai/es/docs/agent-feedback\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.zelto.ai/es/docs/agent-feedback#article\",\"headline\":\"Feedback de agentes\",\"name\":\"Feedback de agentes\",\"description\":\"¿Falta una capacidad o un error de la API bloquea tu tarea? Usá POST /v1/feedback con tu API key habitual para avisar al equipo de Zelto.\",\"url\":\"https://docs.zelto.ai/es/docs/agent-feedback\",\"mainEntityOfPage\":{\"@id\":\"https://docs.zelto.ai/es/docs/agent-feedback#webpage\"},\"dateModified\":\"2026-11-10T20:53:32.676Z\",\"publisher\":{\"@id\":\"https://docs.zelto.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.zelto.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zelto\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Zelto\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/es/docs/agent-feedback.md","siteName":"Zelto","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/docs/agent-feedback"}]},{"language":"es","tabs":[{"tab":"Documentación","icon":"book-open","groups":[{"group":"Primeros pasos","icon":"rocket","pages":[{"title":"Introducción","icon":"house","href":"/es/docs"},{"title":"Inicio rápido: analiza conversaciones en cinco minutos","sidebarTitle":"Inicio rápido","icon":"bolt","href":"/es/docs/quickstart"},{"title":"Empieza a enviar trazas a Zelto","sidebarTitle":"Enviar trazas","icon":"timeline","href":"/es/docs/guides/send-traces"},{"title":"A bordo con un agente","icon":"robot","href":"/es/docs/onboarding-with-an-agent"},{"title":"Cómo funciona Zelto","description":"Desde un proveedor conectado hasta conversaciones, hallazgos y cambios: el recorrido completo.","icon":"gears","href":"/es/docs/how-it-works"},{"title":"Feedback de agentes","href":"/es/docs/agent-feedback"}]},{"group":"Conceptos principales","icon":"cube","pages":[{"title":"Agentes","description":"Cómo representa Zelto los agentes de voz y de texto que impulsan tus conversaciones.","icon":"headset","href":"/es/docs/agents"},{"title":"Versiones de agentes","icon":"code-branch","href":"/es/docs/agent-versions"},{"title":"Empresas","icon":"building","href":"/es/docs/companies"},{"title":"Conversaciones","icon":"comments","href":"/es/docs/conversations"},{"title":"Trazas","icon":"timeline","href":"/es/docs/traces"},{"title":"Invocaciones de herramientas","icon":"wrench","href":"/es/docs/tool-calls"},{"title":"Hallazgos","icon":"flag","href":"/es/docs/findings"},{"title":"Monitores","icon":"signal","href":"/es/docs/monitors"},{"title":"Experimentos","icon":"scale-balanced","href":"/es/docs/experiments"},{"title":"Cambios","icon":"lightbulb","href":"/es/docs/changes"},{"title":"Reportes","icon":"file-chart-column","href":"/es/docs/reports"},{"title":"Simulaciones","icon":"flask","href":"/es/docs/simulations"},{"title":"Benchmarks","icon":"chart-simple","href":"/es/docs/benchmarks"},{"title":"Crear casos con la API","icon":"code","href":"/es/docs/benchmarks/cases-api"}]},{"group":"Integraciones","icon":"puzzle-piece","pages":[{"title":"Integraciones","sidebarTitle":"Resumen","icon":"compass","href":"/es/docs/integrations/index"},{"title":"Webhooks","icon":"webhook","href":"/es/docs/integrations/webhooks"},{"group":"Proveedores de voz","icon":"microphone","pages":[{"title":"Cartesia","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/cartesia.svg","href":"/es/docs/integrations/cartesia"},{"title":"ElevenLabs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/elevenlabs.svg","href":"/es/docs/integrations/elevenlabs"},{"title":"LiveKit","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/livekit.svg","href":"/es/docs/integrations/livekit"},{"title":"Retell","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/retell.svg","href":"/es/docs/integrations/retell"},{"title":"Speechify","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/speechify.svg","href":"/es/docs/integrations/speechify"},{"title":"Telnyx AI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/telnyx.svg","href":"/es/docs/integrations/telnyx"},{"title":"Vapi","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/vapi.svg","href":"/es/docs/integrations/vapi"}]},{"title":"Proveedores personalizados y otros","icon":"cloud-arrow-up","href":"/es/docs/integrations/api-call-upload"},{"title":"Chatbots y conversaciones de texto","icon":"messages","href":"/es/docs/integrations/chatbot-text-conversations"},{"title":"Kapso (WhatsApp)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/kapso.svg","href":"/es/docs/integrations/kapso"},{"title":"Twilio","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/twilio.svg","href":"/es/docs/integrations/twilio"},{"group":"Notificaciones","icon":"bell","pages":[{"title":"Slack","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/slack.svg","href":"/es/docs/integrations/slack"},{"title":"Google Chat","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/googlechat.svg","href":"/es/docs/integrations/google-chat"}]},{"group":"Seguimiento de incidencias","icon":"list-check","pages":[{"title":"Linear","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/linear.svg","href":"/es/docs/integrations/linear"}]},{"title":"MCP","icon":"plug","href":"/es/docs/mcp"},{"title":"Conectar Zelto a Claude","icon":"link","href":"/es/docs/connect-claude"}]},{"group":"Guías","icon":"map","pages":[{"title":"Conectar un proveedor de voz","icon":"link","href":"/es/docs/guides/connect-a-voice-provider"},{"title":"Clasificar hallazgos","icon":"filter","href":"/es/docs/guides/triage-findings"},{"title":"Auditar un agente","icon":"clipboard-list","href":"/es/docs/guides/audit-an-agent"},{"title":"Configurar empresas","icon":"list-check","href":"/es/docs/guides/set-up-companies"},{"title":"Validación de acciones e informes operativos","href":"/es/docs/guides/customer-evaluation-workflows"},{"title":"Administrar tu equipo","icon":"users","href":"/es/docs/guides/manage-your-team"}]},{"group":"Cuenta y configuración","icon":"gear","pages":[{"title":"Planes, límites y retención","icon":"tags","href":"/es/docs/plans"},{"title":"Configuración","icon":"gear","href":"/es/docs/settings"},{"title":"Proveedores de IA","href":"/es/docs/ai-providers"}]},{"group":"Legal","icon":"scale-balanced","pages":[{"title":"Política de privacidad","icon":"shield-halved","href":"/es/docs/legal/privacy-policy"},{"title":"Términos de uso","icon":"file-contract","href":"/es/docs/legal/terms-of-service"}]}]},{"tab":"Referencia de API","icon":"terminal","pages":[{"title":"Referencia de API","href":"/api-reference/monitors/crear-una-exportación-filtrada-de-monitores"}]}]}]},"basePath":"","title":"Feedback de agentes - Zelto","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}