Iniciar conversación saliente de LeadScout con un lead conocido
Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido.
Se respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea.
forceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado.
Una sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto.
Consulta la guía completa de envío saliente para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.
POST
/
bridge
/
api
/
v1
/
workspaces
/
{workspaceId}
/
leadscout
/
outbound
Iniciar conversación saliente de LeadScout con un lead conocido
Copy the API key as provided by the Bridge Console.
Parámetros de ruta
workspaceId
string<uuid>
requerido
Identificador único del workspace (UUID v4).
Ejemplo:
"b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"
Cuerpo
application/json
Cuerpo de la solicitud para iniciar una conversación saliente de LeadScout.
contact
Contact · object
requerido
Lead al que se dirige esta conversación saliente. Ya debe existir en el workspace.
Show child attributes
template
Template · object
requerido
Plantilla inicial que se enviará.
Show child attributes
additionalMessages
OutboundFollowUpRequest · object[]
Hasta cinco mensajes de seguimiento guardados en la conversación en el orden de la solicitud. La persistencia no confirma la entrega. No asumas que estos mensajes esperan la respuesta del lead; consulta la guía de outbound para considerar entrega y reintentos.
Maximum array length: 5
Show child attributes
agentContext
OutboundAgentContextRequest · object | null
Notas y medios guardados en la conversación como contexto del agente para la revisión por IA o una persona.
Show child attributes
consent
OutboundConsentRequest · object | null
Evidencia de consentimiento declarada por la empresa y registrada sin modificaciones en la conversación.
Show child attributes
handoffOverride
LeadscoutOutboundHandoffOverride · object | null
Reemplaza la asignación predeterminada del asesor de la conversación saliente.
Show child attributes
brandId
string | null
ID opcional de marca. Si se proporciona, solo son elegibles los canales vinculados a ella. Omítelo para considerar todos los canales del workspace.
Ejemplo:
null
campaignId
string | null
Referencia opcional de campaña guardada en la conversación para auditoría e informes.
Ejemplo:
null
forceSend
boolean
predeterminado:false
Controla la reutilización de una conversación activa existente con este Contact en la línea elegida. Con false (predeterminado), una línea ocupada seleccionada explícitamente devuelve 409 BRIDGE_AI_LEADSCOUT_0007; la selección automática con solo líneas ocupadas devuelve 409 BRIDGE_AI_LEADSCOUT_0008. Con true, se reutiliza una conversación ocupada apta en lugar de crear una nueva, y una reutilización exitosa establece alreadyInitiated=true. La selección automática prefiere una línea libre, después una conversación liberada recuperable y, por último, una conversación ocupada cuando true. La recuperación es posible con cualquiera de los dos valores y devuelve recovered=true. La ruta heredada de LeadScout puede reutilizar una conversación controlada por un humano; no aplica la comprobación de control del envío saliente de Agents. Esta opción no omite las conversaciones bloqueadas/no recuperables, las comprobaciones de sesión ni otras validaciones y no es una clave de idempotencia. Consulta Envío saliente de Agents y forceSend.
Ejemplos:
false
true
Respuesta
Respuesta satisfactoria
Cuerpo de respuesta de un inicio saliente de LeadScout satisfactorio.
conversation
Conversation · object
requerido
Conversación utilizada para esta solicitud saliente: nueva, reutilizada (alreadyInitiated=true) o recuperada (recovered=true). Una conversación reutilizada conserva su ID; la reutilización legacy, por sí sola, no implica que haya cambiado su controlador.
Show child attributes
contact
Contact · object
requerido
Contacto con el que se inició la conversación.
Show child attributes
templateSent
LeadscoutTemplateSent · object | null
Resumen de la plantilla despachada para abrir la conversación.
Show child attributes
additionalMessagesPersisted
integer
predeterminado:0
Número de mensajes de seguimiento guardados en la conversación.
Ejemplos:
0
3
alreadyInitiated
boolean
predeterminado:false
True cuando esta solicitud satisfactoria reutilizó una conversación activa existente mediante forceSend=true. False para creación o recuperación; consulta recovered para distinguir esas rutas. Es informativo: una reutilización satisfactoria también guarda la nueva plantilla y los seguimientos, por lo que repetir la solicitud puede agregar mensajes.
Ejemplos:
false
true
recovered
boolean
predeterminado:false
True cuando esta solicitud recuperó una conversación liberada que el contacto tenía en el canal elegido, en lugar de crear otra.
Ejemplos:
false
true
¿Esta página le ayudó?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Bridge REST Integrations API \u0026 Webhooks","description":"Official Bridge developer documentation for the REST API, webhooks and Custom Connections: contacts, conversations and messaging. Available in English, Spanish and Brazilian Portuguese.","colors":{"primary":"#3E6EE5","light":"#93B5FF","dark":"#2F58C4"},"logo":{"light":"https://mintcdn.com/sainapsisinc/MRBSc5DvZcNEOxd1/logo/bridge_full_logo_light.png?fit=max\u0026auto=format\u0026n=MRBSc5DvZcNEOxd1\u0026q=85\u0026s=9a9d74ac33a89d538635507ba8d12eb9","dark":"https://mintcdn.com/sainapsisinc/MRBSc5DvZcNEOxd1/logo/bridge_full_logo_dark.png?fit=max\u0026auto=format\u0026n=MRBSc5DvZcNEOxd1\u0026q=85\u0026s=0c0905478472ab3f3b07066824f7f4ca"},"favicon":"https://mintcdn.com/sainapsisinc/OxyPsTqCEnnNpE4v/favicon.png?fit=max\u0026auto=format\u0026n=OxyPsTqCEnnNpE4v\u0026q=85\u0026s=8262683efaf26e188f464e1f0f02a189","appearance":{"default":"light","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0B1220"}},"navbar":{"links":[{"href":"https://docs.bridge.new/connect-your-agent","label":"Connect AI"},{"href":"https://help.bridge.new","label":"Help Center"},{"href":"mailto:support@sainapsis.com","label":"Contact Support"}],"primary":{"type":"button","label":"Bridge app","href":"https://app.bridge.new"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/sainapsis-inc"}},"seo":{"organization":{"name":"Bridge","sameAs":["https://www.linkedin.com/company/sainapsis-inc"]},"indexing":"navigable"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","download-spec"],"display":"header"},"markdown":{"instructions":["Bridge exposes three integration surfaces: the REST Integrations API for pushing data into Bridge, webhooks for receiving events from Bridge, and the public Custom Connections endpoint that a tenant's landing page posts to.","The Integrations API host is https://api-connect-us.bridge.new and every request to it must be authenticated with the x-api-key header. Bridge does not use bearer tokens or OAuth.","The Custom Connections endpoint is different and the Integrations API rules do not apply to it: it has its own host, it takes no x-api-key and no authentication header of any kind, and it is called from a visitor's browser. It is identified by a workspace id and a capture key together with a reCAPTCHA token. Never tell a reader to authenticate it with an API key, and never tell them to keep its capture key out of frontend code - it is designed to live in the page.","REST error catalog keys use BRIDGE_\u003cDOMAIN>_\u003cNNNN>, for example BRIDGE_CONVERSATION_0001. Some reviewed legacy handlers return a recognized code plus a symbolic suffix separated by |; preserve the complete received value and use the compatible catalog lookup on /error-codes. Custom Connections uses separate BRIDGE.CAMPAIGN_LEADS.\u003cNAME> identifiers on its own error reference. Never invent an error code or confuse the two integration surfaces.","This documentation covers the Integrations API, webhooks and Custom Connections only. It does not describe the Bridge web application or its internal APIs.","Before generating an API request, read the relevant OpenAPI specification or the individual endpoint Markdown page. llms-full.txt collects guides and endpoint descriptions; it does not embed every request and response schema. The REST and Custom Connections contracts are separate.","Preserve the published host, method, path, operationId, authentication, headers, parameter and field names, types, formats, required and nullable fields, enums, defaults, limits, and response codes. Do not invent identifiers, fields, retry rules, or delivery guarantees. When published sources conflict, identify the conflicting passages and ask Bridge support to confirm the current behavior before relying on it.","Custom Connections is the current name of the landing-page feature previously documented as Lead Capture. The existing /lead-capture documentation URLs, captureKey field, campaign-leads endpoint, and BRIDGE.CAMPAIGN_LEADS error identifiers are unchanged. This is a naming change, not a change to authentication or the API contract.","For a complete workflow, start with the task guides: /guides/first-conversation, /guides/send-attachments, /guides/send-template, /guides/agent-outbound, /guides/pagination, /guides/identifiers and /guides/responses. Read the endpoint contract as well as the recipe. Outbound requires an existing Contact, but does not require creating a separate Conversation first.","forceSend=true permits reuse of an existing active conversation; it does not create a fresh one by ignoring it and it is not idempotency. Recovery of a released recoverable conversation can occur even with false. The LeadScout and Agents outbound routes have different line-selection and controller checks; use /guides/agent-outbound.","For webhook HMAC, follow /webhooks/verifying-signatures exactly: the Python JSON serialization with sorted keys is signed; X-Bridge-Timestamp is not included in that signature. Do not claim a signed timestamp, raw-body signing, exactly-once delivery or a global event order. Use /webhooks/receive-events for durable acceptance and duplicates.","A 201 message response, 202 handoff or 202 Custom Connections response is not a provider delivery receipt. Do not invent a polling endpoint from messageId, trackingId or requestId. REST validation parsing must tolerate the compatibility difference explained in /error-codes.","The documentation is available in English (existing root URLs), Spanish (/es/) and Brazilian Portuguese (/pt-br/). Prefer the reader's language when a localized page exists, but preserve the API's exact field names, enums, routes, authentication and examples. Translations describe the same API; they do not introduce regional API hosts or behaviors.","For coding-assistant setup, use /connect-your-agent, /es/connect-your-agent or /pt-br/connect-your-agent. The Bridge documentation MCP server reads published documentation and has a separate optional feedback tool. Connecting it does not connect the coding assistant to a customer workspace or authorize live business requests.","For direct HTTP access without MCP, start at https://docs.bridge.new/llms.txt. It lists every published page in English, Spanish and Brazilian Portuguese. Choose /llms-en.json, /llms-es.json or /llms-pt-br.json for a language-specific index, and /llms-full-en.json, /llms-full-es.json or /llms-full-pt-br.json for collected content. /llms-full.txt contains the combined collection. Fetch the original OpenAPI specification for exact schemas.","For HTTP page reads, follow the .md URLs from the index or request Accept: text/markdown at the canonical page URL. The MCP virtual filesystem uses .mdx page paths instead; .mdx is not the public HTTP export extension. With Search MCP, set language to en, es or pt-BR explicitly; its default is en.","For integration capabilities and source-selection rules, read https://docs.bridge.new/skill.md. Documentation access does not authorize business API actions; use the actual user request, workspace, credentials and target identifiers for any live integration."]},"navigation":{"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"https://docs.bridge.new/connect-your-agent","label":"Connect AI"},{"href":"https://help.bridge.new","label":"Help Center"},{"href":"mailto:support@sainapsis.com","label":"Contact Support"}],"primary":{"type":"button","label":"Bridge app","href":"https://app.bridge.new"}},"href":""},{"language":"es","navbar":{"links":[{"href":"https://docs.bridge.new/es/connect-your-agent","label":"Conectar IA"},{"href":"https://help.bridge.new","label":"Centro de ayuda"},{"href":"mailto:support@sainapsis.com","label":"Contactar con soporte"}],"primary":{"type":"button","label":"Aplicación Bridge","href":"https://app.bridge.new"}},"href":"es"},{"language":"pt-BR","navbar":{"links":[{"href":"https://docs.bridge.new/pt-br/connect-your-agent","label":"Conectar IA"},{"href":"https://help.bridge.new","label":"Central de ajuda"},{"href":"mailto:support@sainapsis.com","label":"Falar com o suporte"}],"primary":{"type":"button","label":"Aplicativo Bridge","href":"https://app.bridge.new"}},"href":"pt-br"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sainapsisinc","hasAudioNarration":false,"actualSubdomain":"sainapsisinc","customDomains":["docs.bridge.new"],"gitSource":{"type":"github","owner":"sainapsis","repo":"open-api-public-documentation-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af883875400fbb020663982","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"en","tag":"REST API","count":25},{"language":"es","tag":"API REST","count":25},{"language":"pt-BR","tag":"API REST","count":25},{"language":"en","tag":"Getting started","count":14},{"language":"es","tag":"Primeros pasos","count":14},{"language":"pt-BR","tag":"Primeiros passos","count":14},{"language":"en","tag":"Start here","count":7},{"language":"es","tag":"Empieza aquí","count":7},{"language":"pt-BR","tag":"Comece aqui","count":7},{"language":"en","tag":"Custom Connections","count":6},{"language":"en","tag":"Contacts API","count":6},{"language":"es","tag":"Custom Connections","count":6},{"language":"es","tag":"Contacts API","count":6},{"language":"pt-BR","tag":"Custom Connections","count":6},{"language":"pt-BR","tag":"Contacts API","count":6},{"language":"en","tag":"Reference","count":5},{"language":"en","tag":"Build your integration","count":5},{"language":"en","tag":"Webhooks","count":5},{"language":"en","tag":"Conversations API","count":5},{"language":"es","tag":"Referencia","count":5},{"language":"es","tag":"Crea tu integración","count":5},{"language":"es","tag":"Webhooks","count":5},{"language":"es","tag":"Conversations API","count":5},{"language":"pt-BR","tag":"Referência","count":5},{"language":"pt-BR","tag":"Crie sua integração","count":5},{"language":"pt-BR","tag":"Webhooks","count":5},{"language":"pt-BR","tag":"Conversations API","count":5},{"language":"en","tag":"Internal Users API","count":3},{"language":"es","tag":"Internal Users API","count":3},{"language":"pt-BR","tag":"Internal Users API","count":3}]},"assistantConfig":{},"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":".nav-logo{height:2rem;width:auto;max-width:9rem;object-fit:contain}:root{--bridge-blue: #3e6ee5;--bridge-navy: #0e2841;--bridge-ink: #1a1a2e;--bridge-muted: #6d6c69;--bridge-border: #e1e8f2;--bridge-soft: #f0f5fe;--bridge-teal: #3a8a9c}body{font-family:\"Helvetica Neue\", Roboto, -apple-system, BlinkMacSystemFont, system-ui, sans-serif;-webkit-font-smoothing:antialiased}#page-title{font-weight:500;letter-spacing:-0.035em;line-height:1.15}#content-area h2,#content-area h3{font-weight:500;letter-spacing:-0.02em}html:not(.dark) #page-title,html:not(.dark) #content-area h2,html:not(.dark) #content-area h3{color:var(--bridge-navy)}html:not(.dark) #navbar{background-color:rgba(255, 255, 255, 0.96)}#search-bar-entry,#search-bar-entry-mobile{border-radius:12px}html:not(.dark) #search-bar-entry{background:#fff;border-color:var(--bridge-border);box-shadow:0 1px 3px rgba(14, 40, 65, 0.04)}#topbar-cta-button{border-radius:8px}.card{border-radius:12px;transition:border-color 150ms ease, box-shadow 150ms ease, background-color 150ms ease}html:not(.dark) .card{border-color:var(--bridge-border);background-color:#fff;box-shadow:0 1px 2px rgba(14, 40, 65, 0.035)}html:not(.dark) .card:hover{border-color:#b8ccf5;background-color:#f8faff;box-shadow:0 5px 16px rgba(14, 40, 65, 0.06)}.callout,.code-block{border-radius:12px}#content p,#content li{line-height:1.65}.bridge-surfaces .card{margin-top:0}.card:focus-visible,#navbar a:focus-visible,#sidebar a:focus-visible,#search-bar-entry:focus-visible{outline:2px solid #3865d8;outline-offset:3px}#navbar a:has(.nav-logo){display:inline-flex;align-items:center;min-height:44px}@media (max-width: 640px){.nav-logo{height:1.75rem;max-width:8rem}}@media (prefers-reduced-motion: reduce){.card{transition:none}}.bridge-version-badge{display:inline-block;padding:2px 9px;border-radius:999px;background:rgba(62, 110, 229, 0.10);color:#3e6ee5;font-size:12px;line-height:20px;font-weight:600}.dark .bridge-version-badge{color:#93b5ff}.bridge-comparison{overflow-x:auto;margin:1.25rem 0;border-radius:6px}.bridge-comparison table{display:table;min-width:720px;width:100%;overflow:visible;margin:0}.bridge-comparison:focus-visible{outline:2px solid #3e6ee5;outline-offset:3px}.bridge-ai-start{margin:1.75rem 0 2rem;padding:20px 24px;border:1px solid #cbd9f5;border-radius:14px;background:linear-gradient(135deg, #f0f5fe 0%, #fafcff 100%)}.bridge-ai-start .bridge-ai-eyebrow{margin:0 0 8px;color:#2f58c4;font-size:12px;font-weight:600;line-height:1.4}.bridge-ai-start h2{margin-top:0;margin-bottom:10px;font-size:1.5rem}.bridge-ai-start>p:last-child{margin-bottom:0;font-size:13px}.bridge-ai-providers{display:flex;flex-wrap:wrap;gap:8px;margin:14px 0}.bridge-ai-providers a{display:inline-flex;align-items:center;justify-content:space-between;gap:10px;min-height:44px;padding:9px 12px;border:1px solid #c7d5f0;border-radius:8px;background:#fff;color:#234cae;font-size:14px;font-weight:600;text-decoration:none}.bridge-ai-providers a:hover{border-color:#3e6ee5;background:#f7faff}.bridge-ai-providers a:focus-visible{outline:2px solid #3e6ee5;outline-offset:3px}.dark .bridge-ai-start{background:linear-gradient(135deg, #112441, #0f1b2e);border-color:#29446b}.dark .bridge-ai-start .bridge-ai-eyebrow{color:#b3caff}.dark .bridge-ai-providers a{background:#152640;color:#c1d4ff;border-color:#38537c}.dark .bridge-ai-providers a:hover{background:#1c3356;border-color:#93b5ff}@media (max-width: 640px){.bridge-ai-start{padding:18px}.bridge-ai-providers{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr))}.bridge-ai-providers a{font-size:13px}}#content-area a[id]:not([href]){scroll-margin-top:var(--scroll-mt, 9.5rem)}"}],"page":{"pagePath":"es/api-reference/leadscout-api/iniciar-conversación-saliente-de-leadscout-con-un-lead-conocido","slug":"/es/api-reference/leadscout-api/iniciar-conversación-saliente-de-leadscout-con-un-lead-conocido","pageMetadata":{"title":"Iniciar conversación saliente de LeadScout con un lead conocido","description":"Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido.\n\nSe respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea.\n\nforceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado.\n\nUna sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto.\n\nConsulta [la guía completa de envío saliente](/es/guides/agent-outbound) para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/leadscout/outbound","href":"/es/api-reference/leadscout-api/iniciar-conversación-saliente-de-leadscout-con-un-lead-conocido","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Se respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"forceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Una sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Consulta \", _jsx(_components.a, {\n href: \"/es/guides/agent-outbound\",\n children: \"la guía completa de envío saliente\"\n }), \" para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Iniciar conversación saliente de LeadScout con un lead conocido","description":"Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido.\n\nSe respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea.\n\nforceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado.\n\nUna sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto.\n\nConsulta [la guía completa de envío saliente](/es/guides/agent-outbound) para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/leadscout/outbound","href":"/es/api-reference/leadscout-api/iniciar-conversación-saliente-de-leadscout-con-un-lead-conocido","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["LeadScout API"],"summary":"Iniciar conversación saliente de LeadScout con un lead conocido","description":"Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido.\n\nSe respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea.\n\nforceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado.\n\nUna sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto.\n\nConsulta [la guía completa de envío saliente](/es/guides/agent-outbound) para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.","operationId":"initiate_leadscout_outbound_bridge_api_v1_workspaces__workspaceId__leadscout_outbound_post","security":["b83a6458-8104-43e3-ad55-4fb43d9737a1"],"parameters":["1081aec8-22c9-416b-a26f-e9c44b357cb0"],"requestBody":"235e9e4c-9ded-4e30-8252-43acabc58809","responses":{"201":"0d392e57-054b-4cd2-87c0-b9d4c18ecafa","400":"2d0b7811-c181-4b58-957b-cbeccf76ad60","404":"e6498928-b7be-4ad6-a985-453c1d666408","409":"e1fcf2c1-937c-476c-b913-0e5292cc9ddb","422":"a35f24bb-5655-4549-8982-43d345a3eb4f","429":"6a7a952e-ae55-4e4b-bcd1-bdce3cfb6855","500":"fff18f68-bc5d-48e4-8f03-9463c4c3ba0f"},"method":"post","type":"path","servers":["921771b0-9935-41f7-895b-cd850436d9de"],"path":"/bridge/api/v1/workspaces/{workspaceId}/leadscout/outbound","baseUrlOptions":["https://api-connect-us.bridge.new"],"title":"Iniciar conversación saliente de LeadScout con un lead conocido","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1081aec8-22c9-416b-a26f-e9c44b357cb0":{"name":"workspaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"Identificador único del workspace (UUID v4).","examples":["b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"],"title":"Workspaceid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Identificador único del workspace (UUID v4)."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"contact":{"properties":{"identifier":{"type":"string","title":"Identifier","description":"Identificador del Contact según identifierType: ID de Contact para ID, correo electrónico para EMAIL o teléfono en formato E.164 para PHONE. El Contact ya debe existir en el workspace.","examples":["+573001234567"],"isRequired":true,"uniqueKey":"contact.identifier","typeLabel":"string"},"identifierType":{"type":"string","enum":["ID","EMAIL","PHONE"],"title":"Identifier Type","description":"Tipo de identificador.","examples":["PHONE","EMAIL","ID"],"isRequired":true,"uniqueKey":"contact.identifierType","typeLabel":"enum\u003cstring>"},"messageProviderType":{"type":"string","enum":["WHATSAPP","SMS","TELEGRAM","INSTAGRAM","TWITTER","LINE","FACEBOOK","IMESSAGE","WHATSAPP_TEST","HEYGIA"],"title":"Message Provider Type","description":"Proveedor utilizado para entregar la plantilla.","examples":["WHATSAPP"],"isRequired":true,"uniqueKey":"contact.messageProviderType","typeLabel":"enum\u003cstring>"},"providerChannelId":{"oneOf":[{"type":"string","title":"Provider Channel Identifier","description":"ID opcional de línea explícita de WhatsApp. Si se proporciona, se usa esa línea, que debe pertenecer al workspace y resolver a un Agent de prospección. Si se omite, las líneas elegibles se seleccionan automáticamente: primero las libres, después las liberadas recuperables y, solo con forceSend=true, las ocupadas. Si se indica brandId, se limitan los candidatos a esa marca. El ID de línea no es un número telefónico. Consulta [identificadores](/es/guides/identifiers) y [selección saliente](/es/guides/agent-outbound).","example":"c4f2a1e0-9b8d-4e7c-a6f5-1d2e3f4a5b6c","uniqueKey":"contact.providerChannelId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Provider Channel Identifier","description":"ID opcional de línea explícita de WhatsApp. Si se proporciona, se usa esa línea, que debe pertenecer al workspace y resolver a un Agent de prospección. Si se omite, las líneas elegibles se seleccionan automáticamente: primero las libres, después las liberadas recuperables y, solo con forceSend=true, las ocupadas. Si se indica brandId, se limitan los candidatos a esa marca. El ID de línea no es un número telefónico. Consulta [identificadores](/es/guides/identifiers) y [selección saliente](/es/guides/agent-outbound).","example":"c4f2a1e0-9b8d-4e7c-a6f5-1d2e3f4a5b6c","uniqueKey":"contact.providerChannelId.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.providerChannelId","typeLabel":"string | null"}},"type":"object","required":["identifier","identifierType","messageProviderType"],"title":"Contact","description":"Lead al que se dirige esta conversación saliente. Ya debe existir en el workspace.","isRequired":true,"uniqueKey":"contact","typeLabel":"Contact · object"},"template":{"properties":{"id":{"oneOf":[{"type":"string","title":"Template Identifier","description":"ID de la plantilla registrada (de GET /templates). Si se envían id y name, se usa id.","example":"7e1d2c3b-4a5f-6e7d-8c9b-0a1b2c3d4e5f","uniqueKey":"template.id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Template Identifier","description":"ID de la plantilla registrada (de GET /templates). Si se envían id y name, se usa id.","example":"7e1d2c3b-4a5f-6e7d-8c9b-0a1b2c3d4e5f","uniqueKey":"template.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"template.id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Template Name","description":"Nombre de la plantilla registrada y aprobada por Meta que se enviará. Obligatorio si no se envía id; se ignora si se envía id.","example":"leadscout_outbound_fb_v1","uniqueKey":"template.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Template Name","description":"Nombre de la plantilla registrada y aprobada por Meta que se enviará. Obligatorio si no se envía id; se ignora si se envía id.","example":"leadscout_outbound_fb_v1","uniqueKey":"template.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"template.name","typeLabel":"string | null"},"orderedParams":{"items":{"type":"string","uniqueKey":"template.orderedParams.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Ordered Parameters","description":"Valores proporcionados por el cliente para los slots de parámetros de la plantilla con origen CALLER, en orden de posición.","examples":[["Maria","ACME"]],"uniqueKey":"template.orderedParams","typeLabel":"string[]"},"parameters":{"additionalProperties":{"type":"string","uniqueKey":"template.parameters.additionalProperties","typeLabel":"string"},"type":"object","title":"Parameters","description":"Valores proporcionados por el cliente e indexados por la clave de variable de la plantilla (consulta GET /templates/{id} para obtener las claves), tanto para el cuerpo como para los botones. Prefiere esta opción a orderedParams si la plantilla tiene un botón dinámico. Se rechaza con 422 una clave desconocida o que se superponga con un slot ya cubierto por orderedParams.","examples":[{"recipient_first_name":"Maria","tracking_code":"TRK123"}],"uniqueKey":"template.parameters","typeLabel":"Parameters · object"},"media":{"oneOf":[{"type":"object","title":"OutboundTemplateMedia","description":"Medio opcional de encabezado adjunto al mensaje de plantilla inicial.\n\nProporciona exactamente uno: ``mediaId`` (UUID devuelto por ``POST /bridge/api/v1/workspaces/{workspaceId}/files``) o ``url`` (URL pública de origen obtenida de forma asíncrona por el servicio de descarga por URL).","required":["type"],"properties":{"type":{"type":"string","enum":["IMAGE","VIDEO","GIF"],"title":"Media Type","description":"Tipo de medio del encabezado. Debe coincidir con el configurado para la plantilla en Meta.","examples":["IMAGE","VIDEO"],"isRequired":true,"uniqueKey":"template.media.oneOf.0.type","typeLabel":"enum\u003cstring>"},"mediaId":{"oneOf":[{"type":"string","title":"Media Identifier","description":"UUID devuelto por POST /bridge/api/v1/workspaces/{workspaceId}/files. Mutuamente excluyente con url.","example":null,"uniqueKey":"template.media.oneOf.0.mediaId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Media Identifier","description":"UUID devuelto por POST /bridge/api/v1/workspaces/{workspaceId}/files. Mutuamente excluyente con url.","example":null,"uniqueKey":"template.media.oneOf.0.mediaId.oneOf.1","typeLabel":"null"}],"uniqueKey":"template.media.oneOf.0.mediaId","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","title":"Source URL","description":"URL pública de origen que obtiene de forma asíncrona el servicio de descarga de archivos por URL. Mutuamente excluyente con mediaId.","example":null,"uniqueKey":"template.media.oneOf.0.url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Source URL","description":"URL pública de origen que obtiene de forma asíncrona el servicio de descarga de archivos por URL. Mutuamente excluyente con mediaId.","example":null,"uniqueKey":"template.media.oneOf.0.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"template.media.oneOf.0.url","typeLabel":"string | null"}},"uniqueKey":"template.media.oneOf.0","typeLabel":"OutboundTemplateMedia · object"},{"type":"null","title":"Header Media","description":"Medio opcional de encabezado (imagen o video) que se adjuntará al mensaje de plantilla. Acepta un mediaId precargado o una url pública.","uniqueKey":"template.media.oneOf.1","typeLabel":"null"}],"uniqueKey":"template.media","typeLabel":"OutboundTemplateMedia · object | null"}},"type":"object","title":"Template","description":"Plantilla inicial que se enviará.","isRequired":true,"uniqueKey":"template","typeLabel":"Template · object"},"additionalMessages":{"items":{"properties":{"messageBody":{"type":"string","title":"Message Body","description":"Cuerpo de texto plano del mensaje de seguimiento.","examples":["Just confirming we're still on for tomorrow at 10am."],"isRequired":true,"uniqueKey":"additionalMessages.items.[INDEX].messageBody","typeLabel":"string"},"mediaIds":{"items":{"type":"string","uniqueKey":"additionalMessages.items.[INDEX].mediaIds.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Media Identifiers","description":"El esquema de solicitud lo acepta, pero el flujo saliente compartido actual guarda los seguimientos solo como texto y no adjunta estos IDs de medios. Para medios de la plantilla inicial, usa template.media; para un mensaje de adjunto separado, sigue el flujo de adjuntos de Message.","examples":[[],["7e1d2c3b-4a5f-6e7d-8c9b-0a1b2c3d4e5f"]],"uniqueKey":"additionalMessages.items.[INDEX].mediaIds","typeLabel":"string[]"}},"type":"object","required":["messageBody"],"title":"OutboundFollowUpRequest","description":"Mensaje de seguimiento precargado que se guarda en la conversación junto a la plantilla inicial.","uniqueKey":"additionalMessages.items.[INDEX]","typeLabel":"OutboundFollowUpRequest · object"},"type":"array","maxItems":5,"title":"Additional Messages","description":"Hasta cinco mensajes de seguimiento guardados en la conversación en el orden de la solicitud. La persistencia no confirma la entrega. No asumas que estos mensajes esperan la respuesta del lead; consulta la guía de outbound para considerar entrega y reintentos.","uniqueKey":"additionalMessages","typeLabel":"OutboundFollowUpRequest · object[]"},"agentContext":{"oneOf":[{"type":"object","title":"OutboundAgentContextRequest","description":"Notas y medios guardados en la conversación como contexto del agente para la revisión por IA o una persona.","properties":{"notes":{"oneOf":[{"type":"string","title":"Notes","description":"Notas de texto libre para el agente, limitadas a 2000 caracteres.","maxLength":2000,"example":"Lead asked about pricing tiers last week.","uniqueKey":"agentContext.oneOf.0.notes.oneOf.0","typeLabel":"string"},{"type":"null","title":"Notes","description":"Notas de texto libre para el agente, limitadas a 2000 caracteres.","example":"Lead asked about pricing tiers last week.","uniqueKey":"agentContext.oneOf.0.notes.oneOf.1","typeLabel":"null"}],"uniqueKey":"agentContext.oneOf.0.notes","typeLabel":"string | null"},"mediaIds":{"items":{"type":"string","uniqueKey":"agentContext.oneOf.0.mediaIds.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Media Identifiers","description":"Identificadores opcionales de archivos precargados guardados en la conversación como contexto del agente.","examples":[[],["7e1d2c3b-4a5f-6e7d-8c9b-0a1b2c3d4e5f"]],"uniqueKey":"agentContext.oneOf.0.mediaIds","typeLabel":"string[]"}},"uniqueKey":"agentContext.oneOf.0","typeLabel":"OutboundAgentContextRequest · object"},{"type":"null","title":"Agent Context","description":"Notas y medios opcionales guardados en la conversación como contexto para el agente.","uniqueKey":"agentContext.oneOf.1","typeLabel":"null"}],"uniqueKey":"agentContext","typeLabel":"OutboundAgentContextRequest · object | null"},"consent":{"oneOf":[{"type":"object","title":"OutboundConsentRequest","description":"Evidencia de consentimiento declarada por la empresa y registrada sin modificaciones en la conversación.","required":["status"],"properties":{"status":{"type":"string","enum":["GRANTED","NOT_PROVIDED"],"title":"Status","description":"Estado de consentimiento declarado por la empresa. Usa GRANTED (con capturedAt) para consentimiento explícito o NOT_PROVIDED si la empresa no tiene evidencia que declarar.","examples":["GRANTED","NOT_PROVIDED"],"isRequired":true,"uniqueKey":"consent.oneOf.0.status","typeLabel":"enum\u003cstring>"},"capturedAt":{"oneOf":[{"type":"string","title":"Captured At","description":"Fecha y hora ISO8601 (con milisegundos) en que la empresa obtuvo el consentimiento. Obligatorio con status=GRANTED; se acepta null u omitido con status=NOT_PROVIDED.","format":"date-time","example":"2026-04-20T10:00:00.000Z","uniqueKey":"consent.oneOf.0.capturedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Captured At","description":"Fecha y hora ISO8601 (con milisegundos) en que la empresa obtuvo el consentimiento. Obligatorio con status=GRANTED; se acepta null u omitido con status=NOT_PROVIDED.","example":"2026-04-20T10:00:00.000Z","uniqueKey":"consent.oneOf.0.capturedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"consent.oneOf.0.capturedAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"consent.oneOf.0","typeLabel":"OutboundConsentRequest · object"},{"type":"null","title":"Consent","description":"Evidencia opcional de consentimiento, declarada por la empresa, que se registra en la conversación.","uniqueKey":"consent.oneOf.1","typeLabel":"null"}],"uniqueKey":"consent","typeLabel":"OutboundConsentRequest · object | null"},"handoffOverride":{"oneOf":[{"type":"object","title":"LeadscoutOutboundHandoffOverride","description":"Reemplaza la asignación predeterminada del asesor de la conversación saliente.","required":["preAssignedUser"],"properties":{"preAssignedUser":{"properties":{"identifier":{"type":"string","title":"Identifier","description":"Valor que identifica al usuario interno, interpretado según identifier_type.","examples":["advisor@acme.com","usr_01HZ2K3J4M5N6P7Q8R9S0T1UV2"],"isRequired":true,"uniqueKey":"handoffOverride.oneOf.0.preAssignedUser.identifier","typeLabel":"string"},"identifierType":{"type":"string","enum":["ID","EMAIL"],"title":"Identifier Type","description":"Cómo resolver el identificador. ID busca por ID de usuario interno; EMAIL busca por correo electrónico.","examples":["EMAIL","ID"],"isRequired":true,"uniqueKey":"handoffOverride.oneOf.0.preAssignedUser.identifierType","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"type":"object","required":["identifier","identifierType"],"title":"Pre-assigned User","description":"Usuario interno que se asignará como asesor cuando la IA transfiera la conversación. Se valida durante la solicitud: si el usuario no existe, está inactivo o pertenece a otro workspace, se rechaza antes de crear una conversación.","examples":[{"identifier":"advisor@acme.com","identifierType":"EMAIL"}],"isRequired":true,"uniqueKey":"handoffOverride.oneOf.0.preAssignedUser","typeLabel":"Pre-assigned User · object"}},"additionalProperties":false,"uniqueKey":"handoffOverride.oneOf.0","typeLabel":"LeadscoutOutboundHandoffOverride · object"},{"type":"null","title":"Handoff Override","description":"Opción para preasignar un usuario interno específico como asesor de la transferencia. Se valida durante la solicitud; si falla, se cancela la creación de la conversación.","uniqueKey":"handoffOverride.oneOf.1","typeLabel":"null"}],"uniqueKey":"handoffOverride","typeLabel":"LeadscoutOutboundHandoffOverride · object | null"},"brandId":{"oneOf":[{"type":"string","title":"Brand Identifier","description":"ID opcional de marca. Si se proporciona, solo son elegibles los canales vinculados a ella. Omítelo para considerar todos los canales del workspace.","example":null,"uniqueKey":"brandId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Brand Identifier","description":"ID opcional de marca. Si se proporciona, solo son elegibles los canales vinculados a ella. Omítelo para considerar todos los canales del workspace.","example":null,"uniqueKey":"brandId.oneOf.1","typeLabel":"null"}],"uniqueKey":"brandId","typeLabel":"string | null"},"campaignId":{"oneOf":[{"type":"string","title":"Campaign Identifier","description":"Referencia opcional de campaña guardada en la conversación para auditoría e informes.","example":null,"uniqueKey":"campaignId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Campaign Identifier","description":"Referencia opcional de campaña guardada en la conversación para auditoría e informes.","example":null,"uniqueKey":"campaignId.oneOf.1","typeLabel":"null"}],"uniqueKey":"campaignId","typeLabel":"string | null"},"forceSend":{"type":"boolean","title":"Force Send","description":"Controla la reutilización de una conversación activa existente con este Contact en la línea elegida. Con false (predeterminado), una línea ocupada seleccionada explícitamente devuelve 409 BRIDGE_AI_LEADSCOUT_0007; la selección automática con solo líneas ocupadas devuelve 409 BRIDGE_AI_LEADSCOUT_0008. Con true, se reutiliza una conversación ocupada apta en lugar de crear una nueva, y una reutilización exitosa establece alreadyInitiated=true. La selección automática prefiere una línea libre, después una conversación liberada recuperable y, por último, una conversación ocupada cuando true. La recuperación es posible con cualquiera de los dos valores y devuelve recovered=true. La ruta heredada de LeadScout puede reutilizar una conversación controlada por un humano; no aplica la comprobación de control del envío saliente de Agents. Esta opción no omite las conversaciones bloqueadas/no recuperables, las comprobaciones de sesión ni otras validaciones y no es una clave de idempotencia. Consulta [Envío saliente de Agents y forceSend](/es/guides/agent-outbound).","default":false,"examples":[false,true],"uniqueKey":"forceSend","typeLabel":"boolean"}},"type":"object","required":["contact","template"],"title":"LeadscoutOutboundRequest","description":"Cuerpo de la solicitud para iniciar una conversación saliente de LeadScout.","uniqueKey":"","typeLabel":"LeadscoutOutboundRequest · object"},"examples":{"Example":{"title":"Example","value":{"contact":{"identifier":"+573001234567","identifierType":"PHONE","messageProviderType":"WHATSAPP","providerChannelId":"c4f2a1e0-9b8d-4e7c-a6f5-1d2e3f4a5b6c"},"template":{"id":"7e1d2c3b-4a5f-6e7d-8c9b-0a1b2c3d4e5f","name":"leadscout_outbound_fb_v1","orderedParams":["Maria","ACME"],"parameters":{"recipient_first_name":"Maria","tracking_code":"TRK123"},"media":{"type":"IMAGE","mediaId":null,"url":null}},"additionalMessages":[{"messageBody":"Just confirming we're still on for tomorrow at 10am.","mediaIds":[]}],"agentContext":{"notes":"Lead asked about pricing tiers last week.","mediaIds":[]},"consent":{"status":"GRANTED","capturedAt":"2026-04-20T10:00:00.000Z"},"handoffOverride":{"preAssignedUser":{"identifier":"advisor@acme.com","identifierType":"EMAIL"}},"brandId":null,"campaignId":null,"forceSend":false}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"0d392e57-054b-4cd2-87c0-b9d4c18ecafa":{"description":"Respuesta satisfactoria","content":{"application/json":{"schema":{"properties":{"conversation":{"properties":{"id":{"type":"string","title":"Identifier","description":"Identificador único de la conversación (UUID v4).","examples":["b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"],"isRequired":true,"uniqueKey":"conversation.id","typeLabel":"string"},"workspaceId":{"type":"string","title":"Workspace Identifier","description":"Identificador único del workspace (UUID v4).","examples":["b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"],"isRequired":true,"uniqueKey":"conversation.workspaceId","typeLabel":"string"},"participants":{"properties":{"externals":{"items":{"properties":{"identifier":{"type":"string","title":"Identifier","description":"Valor del identificador del participante.","examples":["ef7ee722-5f95-415a-9a98-81eeae178b11"],"isRequired":true,"uniqueKey":"conversation.participants.externals.items.[INDEX].identifier","typeLabel":"string"},"identifierType":{"type":"string","enum":["ID","EMAIL","PHONE"],"title":"Identifier Type","description":"Tipo de identificador de participantes externos (ID, EMAIL o PHONE).","examples":["EMAIL","PHONE","ID"],"isRequired":true,"uniqueKey":"conversation.participants.externals.items.[INDEX].identifierType","typeLabel":"enum\u003cstring>"},"role":{"type":"string","enum":["INTERNAL","EXTERNAL","BOT"],"title":"Role","description":"Rol del participante en la conversación.","examples":["EXTERNAL","INTERNAL"],"isRequired":true,"uniqueKey":"conversation.participants.externals.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"joinedAt":{"type":"string","format":"date-time","title":"Joined At","description":"Fecha y hora en que el participante se unió a la conversación.","examples":["2004-04-10T09:00:00.000Z"],"isRequired":true,"uniqueKey":"conversation.participants.externals.items.[INDEX].joinedAt","typeLabel":"string\u003cdate-time>"},"lastSeenAt":{"oneOf":[{"type":"string","title":"Last Seen At","description":"Fecha y hora de la última actividad observada del participante.","format":"date-time","example":null,"uniqueKey":"conversation.participants.externals.items.[INDEX].lastSeenAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Seen At","description":"Fecha y hora de la última actividad observada del participante.","example":null,"uniqueKey":"conversation.participants.externals.items.[INDEX].lastSeenAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"conversation.participants.externals.items.[INDEX].lastSeenAt","typeLabel":"string\u003cdate-time> | null"}},"type":"object","required":["identifier","identifierType","role","joinedAt"],"title":"Participant","description":"Objeto que representa al participante externo de la conversación.","uniqueKey":"conversation.participants.externals.items.[INDEX]","typeLabel":"Participant · object"},"type":"array","title":"Externals","description":"Lista de participantes externos.","isRequired":true,"uniqueKey":"conversation.participants.externals","typeLabel":"Participant · object[]"},"internals":{"items":{"properties":{"identifier":{"type":"string","title":"Identifier","description":"Valor del identificador del participante.","examples":["ef7ee722-5f95-415a-9a98-81eeae178b11"],"isRequired":true,"uniqueKey":"conversation.participants.internals.items.[INDEX].identifier","typeLabel":"string"},"identifierType":{"type":"string","enum":["ID","EMAIL"],"title":"Identifier Type","description":"Tipo de identificador de participantes internos (ID o EMAIL).","examples":["EMAIL","ID"],"isRequired":true,"uniqueKey":"conversation.participants.internals.items.[INDEX].identifierType","typeLabel":"enum\u003cstring>"},"role":{"type":"string","enum":["INTERNAL","EXTERNAL","BOT"],"title":"Role","description":"Rol del participante en la conversación.","examples":["EXTERNAL","INTERNAL"],"isRequired":true,"uniqueKey":"conversation.participants.internals.items.[INDEX].role","typeLabel":"enum\u003cstring>"},"joinedAt":{"type":"string","format":"date-time","title":"Joined At","description":"Fecha y hora en que el participante se unió a la conversación.","examples":["2004-04-10T09:00:00.000Z"],"isRequired":true,"uniqueKey":"conversation.participants.internals.items.[INDEX].joinedAt","typeLabel":"string\u003cdate-time>"},"lastSeenAt":{"oneOf":[{"type":"string","title":"Last Seen At","description":"Fecha y hora de la última actividad observada del participante.","format":"date-time","example":null,"uniqueKey":"conversation.participants.internals.items.[INDEX].lastSeenAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Last Seen At","description":"Fecha y hora de la última actividad observada del participante.","example":null,"uniqueKey":"conversation.participants.internals.items.[INDEX].lastSeenAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"conversation.participants.internals.items.[INDEX].lastSeenAt","typeLabel":"string\u003cdate-time> | null"}},"type":"object","required":["identifier","identifierType","role","joinedAt"],"title":"Participant","description":"Objeto que representa al participante interno de la conversación.","uniqueKey":"conversation.participants.internals.items.[INDEX]","typeLabel":"Participant · object"},"type":"array","title":"Internals","description":"Lista de participantes internos.","isRequired":true,"uniqueKey":"conversation.participants.internals","typeLabel":"Participant · object[]"}},"type":"object","required":["externals","internals"],"title":"Participants","description":"Participantes de la conversación.","isRequired":true,"uniqueKey":"conversation.participants","typeLabel":"Participants · object"},"createdAt":{"type":"string","format":"date-time","title":"Created At","description":"Fecha y hora de creación de la conversación.","examples":["2003-04-10T09:00:00.000Z"],"isRequired":true,"uniqueKey":"conversation.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","title":"Updated At","description":"Fecha y hora de la última actualización de la conversación.","examples":["2003-04-10T09:00:00.000Z"],"isRequired":true,"uniqueKey":"conversation.updatedAt","typeLabel":"string\u003cdate-time>"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Nombre o título opcional de la conversación.","example":"Bridge Support Team","uniqueKey":"conversation.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Nombre o título opcional de la conversación.","example":"Bridge Support Team","uniqueKey":"conversation.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"conversation.name","typeLabel":"string | null"},"status":{"oneOf":[{"type":"string","title":"ConversationStatus","description":"Estado actual de la conversación: 'ACTIVE' para conversaciones visibles y 'GHOST' para conversaciones invisibles hasta la primera interacción.","enum":["ACTIVE","GHOST","RELEASED","NOT_ASSIGNED_TO_HUMAN","BLOCKED"],"example":"ACTIVE","uniqueKey":"conversation.status.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Status","description":"Estado actual de la conversación: 'ACTIVE' para conversaciones visibles y 'GHOST' para conversaciones invisibles hasta la primera interacción.","example":"ACTIVE","uniqueKey":"conversation.status.oneOf.1","typeLabel":"null"}],"uniqueKey":"conversation.status","typeLabel":"enum\u003cstring> | null"}},"type":"object","required":["id","workspaceId","participants","createdAt","updatedAt"],"title":"Conversation","description":"Conversación utilizada para esta solicitud saliente: nueva, reutilizada (alreadyInitiated=true) o recuperada (recovered=true). Una conversación reutilizada conserva su ID; la reutilización legacy, por sí sola, no implica que haya cambiado su controlador.","isRequired":true,"uniqueKey":"conversation","typeLabel":"Conversation · object"},"contact":{"properties":{"id":{"type":"string","title":"Identifier","description":"Identificador único del contacto (UUID v4).","examples":["b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234"],"isRequired":true,"uniqueKey":"contact.id","typeLabel":"string"},"workspaceId":{"type":"string","title":"Workspace Identifier","description":"Identificador único del workspace al que pertenece este contacto","examples":["92b2d4f3-81e1-4b61-a7ec-6f4ff3b58be5"],"isRequired":true,"uniqueKey":"contact.workspaceId","typeLabel":"string"},"type":{"type":"string","enum":["PARTIAL","NORMAL"],"title":"Contact Type","description":"NORMAL cuando están presentes todos los campos obligatorios de identidad y atributos personalizados; PARTIAL en caso contrario.","examples":["NORMAL","PARTIAL"],"isRequired":true,"uniqueKey":"contact.type","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","title":"Created At","description":"Fecha y hora de creación del contacto.","examples":["2003-04-10T08:00:00.000Z"],"isRequired":true,"uniqueKey":"contact.createdAt","typeLabel":"string"},"updatedAt":{"type":"string","title":"Updated At","description":"Fecha y hora de la última actualización del contacto.","examples":["2003-04-10T08:00:00.000Z"],"isRequired":true,"uniqueKey":"contact.updatedAt","typeLabel":"string"},"firstName":{"oneOf":[{"type":"string","title":"First Name","description":"Nombre del contacto.","example":"John","uniqueKey":"contact.firstName.oneOf.0","typeLabel":"string"},{"type":"null","title":"First Name","description":"Nombre del contacto.","example":"John","uniqueKey":"contact.firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","title":"Last Name","description":"Apellido del contacto.","example":"Doe","uniqueKey":"contact.lastName.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Name","description":"Apellido del contacto.","example":"Doe","uniqueKey":"contact.lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.lastName","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","title":"Email","description":"Correo electrónico del contacto.","format":"email","example":"john.doe@example.com","uniqueKey":"contact.email.oneOf.0","typeLabel":"string\u003cemail>"},{"type":"null","title":"Email","description":"Correo electrónico del contacto.","example":"john.doe@example.com","uniqueKey":"contact.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.email","typeLabel":"string\u003cemail> | null"},"cellphone":{"oneOf":[{"type":"string","title":"Cellphone","description":"Número de celular del contacto.","format":"phone","example":"+14084029292","uniqueKey":"contact.cellphone.oneOf.0","typeLabel":"string\u003cphone>"},{"type":"null","title":"Cellphone","description":"Número de celular del contacto.","example":"+14084029292","uniqueKey":"contact.cellphone.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.cellphone","typeLabel":"string\u003cphone> | null"},"customAttributes":{"items":{"properties":{"key":{"type":"string","title":"Key","description":"Clave o nombre del atributo","isRequired":true,"uniqueKey":"contact.customAttributes.items.[INDEX].key","typeLabel":"string"},"values":{"items":{"type":"string","uniqueKey":"contact.customAttributes.items.[INDEX].values.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Values","description":"Valor del atributo","uniqueKey":"contact.customAttributes.items.[INDEX].values","typeLabel":"string[]"}},"type":"object","required":["key"],"title":"CustomAttributeResponse","description":"Cuerpo de respuesta para atributos personalizados en operaciones con contactos.","uniqueKey":"contact.customAttributes.items.[INDEX]","typeLabel":"CustomAttributeResponse · object"},"type":"array","title":"Custom Attributes","description":"Lista de atributos personalizados de clave y valor.","uniqueKey":"contact.customAttributes","typeLabel":"CustomAttributeResponse · object[]"},"languageCode":{"oneOf":[{"type":"string","title":"LanguageCode","description":"Código de idioma del usuario externo.","enum":["ES","EN","AF","SQ","AR","AZ","BN","BG","CA","ZH_CN","HR","CS","DA","NL","ET","FIL","FI","FR","KA","DE","EL","GU","HA","HE","HI","HU","ID","GA","IT","JA","KN","KK","RW_RW","KO","KY_KG","LO","LV","LT","MK","MS","ML","MR","NB","FA","PL","PT_BR","PA","RO","RU","SR","SK","SL","SW","SV","TA","TE","TH","TR","UK","UR","UZ","VI","ZU"],"example":"EN","uniqueKey":"contact.languageCode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Language Code","description":"Código de idioma del usuario externo.","example":"EN","uniqueKey":"contact.languageCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.languageCode","typeLabel":"enum\u003cstring> | null"},"ownerId":{"oneOf":[{"type":"string","title":"Owner Identifier","description":"ID del Bridge User propietario del contacto. Resuélvelo con `GET /users/{userId}`.","example":"37673840-6259-40f9-bbe5-a7db40f8e3cf","uniqueKey":"contact.ownerId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Owner Identifier","description":"ID del Bridge User propietario del contacto. Resuélvelo con `GET /users/{userId}`.","example":"37673840-6259-40f9-bbe5-a7db40f8e3cf","uniqueKey":"contact.ownerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"contact.ownerId","typeLabel":"string | null"}},"type":"object","required":["id","workspaceId","type","createdAt","updatedAt"],"title":"Contact","description":"Contacto con el que se inició la conversación.","isRequired":true,"uniqueKey":"contact","typeLabel":"Contact · object"},"templateSent":{"oneOf":[{"type":"object","title":"LeadscoutTemplateSent","description":"Resumen de la plantilla despachada para abrir la conversación.","required":["name"],"properties":{"name":{"type":"string","title":"Template Name","description":"Nombre de la plantilla despachada.","examples":["leadscout_outbound_fb_v1"],"isRequired":true,"uniqueKey":"templateSent.oneOf.0.name","typeLabel":"string"},"id":{"oneOf":[{"type":"string","title":"Template Identifier","description":"ID de la plantilla enviada.","example":"7e1d2c3b-4a5f-6e7d-8c9b-0a1b2c3d4e5f","uniqueKey":"templateSent.oneOf.0.id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Template Identifier","description":"ID de la plantilla enviada.","example":"7e1d2c3b-4a5f-6e7d-8c9b-0a1b2c3d4e5f","uniqueKey":"templateSent.oneOf.0.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"templateSent.oneOf.0.id","typeLabel":"string | null"},"messageId":{"oneOf":[{"type":"string","title":"Message Identifier","description":"wamid de Meta de la plantilla despachada. Es null en el flujo satisfactorio hasta que el proceso de envío devuelva el wamid a la API de entrada.","example":null,"uniqueKey":"templateSent.oneOf.0.messageId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Message Identifier","description":"wamid de Meta de la plantilla despachada. Es null en el flujo satisfactorio hasta que el proceso de envío devuelva el wamid a la API de entrada.","example":null,"uniqueKey":"templateSent.oneOf.0.messageId.oneOf.1","typeLabel":"null"}],"uniqueKey":"templateSent.oneOf.0.messageId","typeLabel":"string | null"}},"uniqueKey":"templateSent.oneOf.0","typeLabel":"LeadscoutTemplateSent · object"},{"type":"null","title":"Template Sent","description":"Resumen de la plantilla despachada.","uniqueKey":"templateSent.oneOf.1","typeLabel":"null"}],"uniqueKey":"templateSent","typeLabel":"LeadscoutTemplateSent · object | null"},"additionalMessagesPersisted":{"type":"integer","title":"Additional Messages Persisted","description":"Número de mensajes de seguimiento guardados en la conversación.","default":0,"examples":[0,3],"uniqueKey":"additionalMessagesPersisted","typeLabel":"integer"},"alreadyInitiated":{"type":"boolean","title":"Already Initiated","description":"True cuando esta solicitud satisfactoria reutilizó una conversación activa existente mediante forceSend=true. False para creación o recuperación; consulta recovered para distinguir esas rutas. Es informativo: una reutilización satisfactoria también guarda la nueva plantilla y los seguimientos, por lo que repetir la solicitud puede agregar mensajes.","default":false,"examples":[false,true],"uniqueKey":"alreadyInitiated","typeLabel":"boolean"},"recovered":{"type":"boolean","title":"Recovered","description":"True cuando esta solicitud recuperó una conversación liberada que el contacto tenía en el canal elegido, en lugar de crear otra.","default":false,"examples":[false,true],"uniqueKey":"recovered","typeLabel":"boolean"}},"type":"object","required":["conversation","contact"],"title":"LeadscoutOutboundResponse","description":"Cuerpo de respuesta de un inicio saliente de LeadScout satisfactorio.","uniqueKey":"","typeLabel":"LeadscoutOutboundResponse · object"},"examples":{"Example":{"title":"Example","value":{"conversation":{"id":"b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234","workspaceId":"b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234","participants":{"externals":[{"identifier":"ef7ee722-5f95-415a-9a98-81eeae178b11","identifierType":"EMAIL","role":"EXTERNAL","joinedAt":"2004-04-10T09:00:00.000Z","lastSeenAt":null}],"internals":[{"identifier":"ef7ee722-5f95-415a-9a98-81eeae178b11","identifierType":"EMAIL","role":"EXTERNAL","joinedAt":"2004-04-10T09:00:00.000Z","lastSeenAt":null}]},"createdAt":"2003-04-10T09:00:00.000Z","updatedAt":"2003-04-10T09:00:00.000Z","name":"Bridge Support Team","status":"ACTIVE"},"contact":{"id":"b6cf1c4a-2b1e-4e63-8f3e-0f9d1a2a1234","workspaceId":"92b2d4f3-81e1-4b61-a7ec-6f4ff3b58be5","type":"NORMAL","createdAt":"2003-04-10T08:00:00.000Z","updatedAt":"2003-04-10T08:00:00.000Z","firstName":"John","lastName":"Doe","email":"john.doe@example.com","cellphone":"+14084029292","customAttributes":[{"key":"\u003cstring>","values":["\u003cstring>"]}],"languageCode":"EN","ownerId":"37673840-6259-40f9-bbe5-a7db40f8e3cf"},"templateSent":{"name":"leadscout_outbound_fb_v1","id":"7e1d2c3b-4a5f-6e7d-8c9b-0a1b2c3d4e5f","messageId":null},"additionalMessagesPersisted":0,"alreadyInitiated":false,"recovered":false}}},"exampleType":"generated"}},"exampleType":"generated"},"2d0b7811-c181-4b58-957b-cbeccf76ad60":{"description":"Solicitud incorrecta","content":{"application/json":{"examples":{"OUTBOUND_VALIDATION_ERROR":{"title":"OUTBOUND_VALIDATION_ERROR","value":{"title":"Outbound Validation Error","status":400,"code":"BRIDGE_AI_LEADSCOUT_0016"}},"TEMPLATE_ORDERED_PARAMS_MISMATCH":{"title":"TEMPLATE_ORDERED_PARAMS_MISMATCH","value":{"title":"Template Params Mismatch","status":400,"code":"BRIDGE_AI_LEADSCOUT_0006"}}},"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Resumen breve del tipo de problema.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"Código de estado HTTP generado por el servidor de origen para esta instancia del problema.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Información adicional sobre el problema.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Información adicional sobre el problema.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Objeto que representa el cuerpo de una respuesta Problem.","uniqueKey":"","typeLabel":"Problem · object"},"exampleType":"examples"}},"exampleType":"examples"},"e6498928-b7be-4ad6-a985-453c1d666408":{"description":"No encontrado","content":{"application/json":{"examples":{"EXTERNAL_USER_NOT_FOUND":{"title":"EXTERNAL_USER_NOT_FOUND","value":{"title":"External User Not Found","status":404,"code":"BRIDGE_AI_LEADSCOUT_0001"}},"INTERNAL_USER_NOT_FOUND":{"title":"INTERNAL_USER_NOT_FOUND","value":{"title":"Internal User Not Found","status":404,"code":"BRIDGE_AI_LEADSCOUT_0002"}},"TEMPLATE_NOT_FOUND":{"title":"TEMPLATE_NOT_FOUND","value":{"title":"Template Not Found","status":404,"code":"BRIDGE_AI_LEADSCOUT_0004"}},"NO_CHANNELS_FOR_BRAND":{"title":"NO_CHANNELS_FOR_BRAND","value":{"title":"No Channels For Brand","status":404,"code":"BRIDGE_AI_LEADSCOUT_0009"}},"PROVIDER_CHANNEL_NOT_IN_WORKSPACE":{"title":"PROVIDER_CHANNEL_NOT_IN_WORKSPACE","value":{"title":"Channel Not In Workspace","status":404,"code":"BRIDGE_AI_LEADSCOUT_0010"}},"WORKSPACE_HAS_NO_PROVIDER_CHANNELS":{"title":"WORKSPACE_HAS_NO_PROVIDER_CHANNELS","value":{"title":"No Provider Channels","status":404,"code":"BRIDGE_AI_LEADSCOUT_0011"}},"NO_PROSPECTING_AGENT_FOR_CHANNEL":{"title":"NO_PROSPECTING_AGENT_FOR_CHANNEL","value":{"title":"No Agent For Channel","status":404,"code":"BRIDGE_AI_LEADSCOUT_0012"}}},"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Resumen breve del tipo de problema.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"Código de estado HTTP generado por el servidor de origen para esta instancia del problema.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Información adicional sobre el problema.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Información adicional sobre el problema.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Objeto que representa el cuerpo de una respuesta Problem.","uniqueKey":"","typeLabel":"Problem · object"},"exampleType":"examples"}},"exampleType":"examples"},"e1fcf2c1-937c-476c-b913-0e5292cc9ddb":{"description":"Conflicto","content":{"application/json":{"examples":{"INTERNAL_USER_DELETED":{"title":"INTERNAL_USER_DELETED","value":{"title":"Internal User Deleted","status":409,"code":"BRIDGE_AI_LEADSCOUT_0003"}},"TEMPLATE_NOT_APPROVED":{"title":"TEMPLATE_NOT_APPROVED","value":{"title":"Template Not Approved","status":409,"code":"BRIDGE_AI_LEADSCOUT_0005"}},"ACTIVE_CONVERSATION_ALREADY_EXISTS":{"title":"ACTIVE_CONVERSATION_ALREADY_EXISTS","value":{"title":"Active Conversation Exists","status":409,"code":"BRIDGE_AI_LEADSCOUT_0007"}},"ALL_PROVIDER_CHANNELS_OCCUPIED":{"title":"ALL_PROVIDER_CHANNELS_OCCUPIED","value":{"title":"All Channels Occupied","status":409,"code":"BRIDGE_AI_LEADSCOUT_0008"}},"MULTIPLE_PROSPECTING_AGENTS_FOR_BRAND":{"title":"MULTIPLE_PROSPECTING_AGENTS_FOR_BRAND","value":{"title":"Multiple Agents For Brand","status":409,"code":"BRIDGE_AI_LEADSCOUT_0013"}},"MULTIPLE_PROSPECTING_AGENTS_FOR_CHANNEL":{"title":"MULTIPLE_PROSPECTING_AGENTS_FOR_CHANNEL","value":{"title":"Multiple Agents For Channel","status":409,"code":"BRIDGE_AI_LEADSCOUT_0014"}}},"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Resumen breve del tipo de problema.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"Código de estado HTTP generado por el servidor de origen para esta instancia del problema.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Información adicional sobre el problema.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Información adicional sobre el problema.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Objeto que representa el cuerpo de una respuesta Problem.","uniqueKey":"","typeLabel":"Problem · object"},"exampleType":"examples"}},"exampleType":"examples"},"a35f24bb-5655-4549-8982-43d345a3eb4f":{"description":"Contenido no procesable","content":{"application/json":{"examples":{"MISSING_TEMPLATE_VARIABLES":{"title":"MISSING_TEMPLATE_VARIABLES","value":{"title":"Missing Template Variables","status":422,"code":"BRIDGE_AI_LEADSCOUT_0019"}},"CONFLICTING_TEMPLATE_PARAMETERS":{"title":"CONFLICTING_TEMPLATE_PARAMETERS","value":{"title":"Conflicting Template Parameters","status":422,"code":"BRIDGE_AI_LEADSCOUT_0020"}},"UNKNOWN_TEMPLATE_PARAMETER_KEY":{"title":"UNKNOWN_TEMPLATE_PARAMETER_KEY","value":{"title":"Unknown Template Parameter Key","status":422,"code":"BRIDGE_AI_LEADSCOUT_0021"}}},"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Resumen breve del tipo de problema.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"Código de estado HTTP generado por el servidor de origen para esta instancia del problema.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Información adicional sobre el problema.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Información adicional sobre el problema.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Objeto que representa el cuerpo de una respuesta Problem.","uniqueKey":"","typeLabel":"Problem · object"},"exampleType":"examples"}},"exampleType":"examples"},"6a7a952e-ae55-4e4b-bcd1-bdce3cfb6855":{"description":"Demasiadas solicitudes","content":{"application/json":{"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Resumen breve del tipo de problema.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"Código de estado HTTP generado por el servidor de origen para esta instancia del problema.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Información adicional sobre el problema.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Información adicional sobre el problema.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Objeto que representa el cuerpo de una respuesta Problem.","uniqueKey":"","typeLabel":"Problem · object"},"examples":{"WORKSPACE_BUDGET_EXHAUSTED":{"title":"WORKSPACE_BUDGET_EXHAUSTED","value":{"title":"Too Many Requests","status":429,"code":"BRIDGE_RATE_LIMIT_0001"}}},"exampleType":"examples"}},"exampleType":"examples"},"fff18f68-bc5d-48e4-8f03-9463c4c3ba0f":{"description":"Error interno del servidor","content":{"application/json":{"examples":{"CONVERSATION_OPERATION_FAILED":{"title":"CONVERSATION_OPERATION_FAILED","value":{"title":"Conversation Operation Failed","status":500,"code":"BRIDGE_AI_LEADSCOUT_0015"}}},"schema":{"properties":{"title":{"type":"string","title":"Title","description":"Resumen breve del tipo de problema.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","title":"Status","description":"Código de estado HTTP generado por el servidor de origen para esta instancia del problema.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"null","title":"Detail","description":"Explicación específica de esta instancia del problema.","uniqueKey":"detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.0","typeLabel":"string"},{"type":"null","title":"Instance","description":"Referencia URI que identifica esta instancia del problema.","uniqueKey":"instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"instance","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.0","typeLabel":"string"},{"type":"null","title":"Traceid","description":"ID de seguimiento para depuración.","uniqueKey":"traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"traceId","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.0","typeLabel":"string"},{"type":"null","title":"Code","description":"Código para identificar el error; consulta la página de códigos de error para más detalles.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"string | null"},"errors":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.0","typeLabel":"Errors · object[]"},{"type":"null","title":"Errors","description":"Lista de detalles de errores.","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"Errors · object[] | null"},"extra":{"oneOf":[{"type":"object","title":"Extra","description":"Información adicional sobre el problema.","additionalProperties":true,"uniqueKey":"extra.oneOf.0","typeLabel":"Extra · object"},{"type":"null","title":"Extra","description":"Información adicional sobre el problema.","uniqueKey":"extra.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra","typeLabel":"Extra · object | null"}},"type":"object","required":["title","status"],"title":"Problem","description":"Objeto que representa el cuerpo de una respuesta Problem.","uniqueKey":"","typeLabel":"Problem · object"},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"b83a6458-8104-43e3-ad55-4fb43d9737a1":{"x-api-key":{"type":"apiKey","description":"Copy the API key as provided by the Bridge Console.","in":"header","name":"x-api-key","scopes":[],"schemeName":"x-api-key"}}},"servers":{"921771b0-9935-41f7-895b-cd850436d9de":{"url":"https://api-connect-us.bridge.new","description":"Servidor de producción"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","description":"Copy the API key as provided by the Bridge Console.","in":"header","name":"x-api-key","scopes":[],"schemeName":"x-api-key"},"schema":{"title":"x-api-key","type":"string","description":"Copy the API key as provided by the Bridge Console.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x-api-key","name":"x-api-key"}],"title":"x-api-key"}]},"originalFileLocation":"es/api-reference/openapi.yaml"},"subdomain":"sainapsisinc","siteName":"Bridge REST Integrations API \u0026 Webhooks","title":"Iniciar conversación saliente de LeadScout con un lead conocido - Bridge REST Integrations API \u0026 Webhooks","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/","matchLevel":4},"es":{"href":"/es/api-reference/leadscout-api/iniciar-conversación-saliente-de-leadscout-con-un-lead-conocido","matchLevel":0},"pt-BR":{"href":"/pt-br","matchLevel":4}}},"lastModified":"2026-11-14T14:03:18.096Z","originalFileLocation":"es/api-reference/leadscout-api/iniciar-conversación-saliente-de-leadscout-con-un-lead-conocido.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=\"light\"}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=\"Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido. Se respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea. forceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado. Una sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto. Consulta la guía completa de envío saliente para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_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/sainapsisinc/LWksyfunHyleJ2tH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Iniciar conversación saliente de LeadScout con un lead conocido - Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head property=\"og:description\" content=\"Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido. Se respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea. forceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado. Una sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto. Consulta la guía completa de envío saliente para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversación-saliente-de-leadscout-con-un-lead-conocido\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sainapsisinc.mintlify.site/_mintlify/api/og/v2?division=LeadScout+API\u0026amp;title=Iniciar+conversaci%C3%B3n+saliente+de+LeadScout+con+un+lead+conocido\u0026amp;description=Inicia+una+conversaci%C3%B3n+saliente+de+LeadScout+con+un+Contact+conocido.+El+Contact+debe+existir+previamente.+Bridge+selecciona+un+Agent+de+prospecci%C3%B3n+para+una+l\u0026amp;theme=54622e39a2ddcb12e13b2897\u0026amp;signature=0a5b34a27aebae189c1e294c0a1a7f9f032c5c709388d798f3adee85dbfad8db\">\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=\"Iniciar conversación saliente de LeadScout con un lead conocido - Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido. Se respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea. forceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado. Una sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto. Consulta la guía completa de envío saliente para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sainapsisinc.mintlify.site/_mintlify/api/og/v2?division=LeadScout+API\u0026amp;title=Iniciar+conversaci%C3%B3n+saliente+de+LeadScout+con+un+lead+conocido\u0026amp;description=Inicia+una+conversaci%C3%B3n+saliente+de+LeadScout+con+un+Contact+conocido.+El+Contact+debe+existir+previamente.+Bridge+selecciona+un+Agent+de+prospecci%C3%B3n+para+una+l\u0026amp;theme=54622e39a2ddcb12e13b2897\u0026amp;signature=0a5b34a27aebae189c1e294c0a1a7f9f032c5c709388d798f3adee85dbfad8db\">\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/sainapsisinc/LWksyfunHyleJ2tH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Bridge REST Integrations API \u0026amp; Webhooks\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3E6EE5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversación-saliente-de-leadscout-con-un-lead-conocido\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bridge.new/#organization\",\"name\":\"Bridge\",\"url\":\"https://docs.bridge.new\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sainapsisinc/MRBSc5DvZcNEOxd1/logo/bridge_full_logo_light.png?fit=max\u0026auto=format\u0026n=MRBSc5DvZcNEOxd1\u0026q=85\u0026s=9a9d74ac33a89d538635507ba8d12eb9\"},\"sameAs\":[\"https://www.linkedin.com/company/sainapsis-inc\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bridge.new#website\",\"name\":\"Bridge REST Integrations API \u0026 Webhooks\",\"url\":\"https://docs.bridge.new\",\"publisher\":{\"@id\":\"https://docs.bridge.new/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido#webpage\",\"url\":\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido\",\"name\":\"Iniciar conversación saliente de LeadScout con un lead conocido\",\"description\":\"Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido. Se respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea. forceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado. Una sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto. Consulta la guía completa de envío saliente para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.\",\"dateModified\":\"2026-11-14T14:03:18.096Z\",\"isPartOf\":{\"@id\":\"https://docs.bridge.new#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Bridge REST Integrations API \u0026 Webhooks\",\"item\":\"https://docs.bridge.new\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Iniciar conversación saliente de LeadScout con un lead conocido\",\"item\":\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido#apireference\",\"headline\":\"Iniciar conversación saliente de LeadScout con un lead conocido\",\"name\":\"Iniciar conversación saliente de LeadScout con un lead conocido\",\"description\":\"Inicia una conversación saliente de LeadScout con un Contact conocido. El Contact debe existir previamente. Bridge selecciona un Agent de prospección para una línea de WhatsApp apta. La plantilla se referencia mediante template.id o template.name; id tiene prioridad si se proporcionan ambos. Debe existir y estar APPROVED, y cualquier Bridge User de handoffOverride debe ser válido. Se respeta un contact.providerChannelId explícito. Sin él, la selección automática prefiere una línea libre, después una conversación liberada recuperable con este Contact y, por último, una conversación activa ocupada solo cuando forceSend=true. La disponibilidad se evalúa por Contact en cada línea, no por la ocupación global de la línea. forceSend=true reutiliza una conversación activa apta; no la ignora ni crea una nueva. Una reutilización exitosa devuelve alreadyInitiated=true y persiste la nueva plantilla y los seguimientos. Una conversación liberada recuperable se puede recuperar con cualquiera de los dos valores, conserva su ID y devuelve recovered=true. Esta opción no habilita las conversaciones bloqueadas ni las liberadas no recuperables. La ruta heredada puede reutilizar una conversación controlada por un humano u otro Agent; a diferencia del envío saliente de Agents, no exige la comprobación de control por el Agent solicitado. Una sesión abierta de LeadScout que no haya vencido sigue bloqueando una nueva solicitud saliente con 409 BRIDGE_AI_LEADSCOUT_0017; si no se puede finalizar una sesión vencida, devuelve 409 BRIDGE_AI_LEADSCOUT_0018. Las demás validaciones siguen vigentes. Los mensajes adicionales se persisten; persistirlos no demuestra su entrega ni que se espere la respuesta del lead. Una solicitud fallida puede dejar trabajo parcial, por lo que no debes tratar forceSend como idempotencia ni reintentar a ciegas un resultado incierto. Consulta la guía completa de envío saliente para la matriz false/true, los indicadores de respuesta, las diferencias con el envío saliente de Agents, los errores y la transferencia.\",\"url\":\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bridge.new/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido#webpage\"},\"dateModified\":\"2026-11-14T14:03:18.096Z\",\"publisher\":{\"@id\":\"https://docs.bridge.new/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bridge.new#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Bridge REST Integrations API \u0026 Webhooks\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Bridge\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/es/api-reference/leadscout-api/iniciar-conversaci%C3%B3n-saliente-de-leadscout-con-un-lead-conocido.md","siteName":"Bridge REST Integrations API \u0026 Webhooks","nav":{"global":null,"languages":[{"language":"en","default":true,"navbar":{"links":[{"href":"https://docs.bridge.new/connect-your-agent","label":"Connect AI"},{"href":"https://help.bridge.new","label":"Help Center"},{"href":"mailto:support@sainapsis.com","label":"Contact Support"}],"primary":{"type":"button","label":"Bridge app","href":"https://app.bridge.new"}},"pages":[{"title":"en","href":"/"}]},{"language":"es","navbar":{"links":[{"href":"https://docs.bridge.new/es/connect-your-agent","label":"Conectar IA"},{"href":"https://help.bridge.new","label":"Centro de ayuda"},{"href":"mailto:support@sainapsis.com","label":"Contactar con soporte"}],"primary":{"type":"button","label":"Aplicación Bridge","href":"https://app.bridge.new"}},"tabs":[{"tab":"Primeros pasos","pages":[{"title":"Primeros pasos","href":"/es"}]},{"tab":"API REST","groups":[{"group":"Health","pages":[{"title":"Comprobar estado","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/health","href":"/es/api-reference/health/comprobar-estado"}]},{"group":"Conversations API","pages":[{"title":"Obtener conversación por ID","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/conversations/{conversationId}","href":"/es/api-reference/conversations-api/obtener-conversación-por-id"},{"title":"Actualizar conversación","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml patch /bridge/api/v1/workspaces/{workspaceId}/conversations/{conversationId}","href":"/es/api-reference/conversations-api/actualizar-conversación"},{"title":"Consultar conversaciones con filtros flexibles","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/conversations","href":"/es/api-reference/conversations-api/consultar-conversaciones-con-filtros-flexibles"},{"title":"Crear conversación con identificación flexible de usuarios","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/conversations","href":"/es/api-reference/conversations-api/crear-conversación-con-identificación-flexible-de-usuarios"},{"title":"Liberar conversación","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/conversations/{conversationId}/release","href":"/es/api-reference/conversations-api/liberar-conversación"}]},{"group":"Messages API","pages":[{"title":"Crear mensaje","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/messages","href":"/es/api-reference/messages-api/crear-mensaje"}]},{"group":"Contacts API","pages":[{"title":"Obtener contacto por un identificador","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/contacts/lookup","href":"/es/api-reference/contacts-api/obtener-contacto-por-un-identificador"},{"title":"Obtener contacto por ID","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/contacts/{contactId}","href":"/es/api-reference/contacts-api/obtener-contacto-por-id"},{"title":"Actualizar contacto","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml patch /bridge/api/v1/workspaces/{workspaceId}/contacts/{contactId}","href":"/es/api-reference/contacts-api/actualizar-contacto"},{"title":"Listar contactos","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/contacts","href":"/es/api-reference/contacts-api/listar-contactos"},{"title":"Crear contacto","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/contacts","href":"/es/api-reference/contacts-api/crear-contacto"},{"title":"Crear o actualizar contacto","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/contacts/partial","href":"/es/api-reference/contacts-api/crear-o-actualizar-contacto"}]},{"group":"Files API","pages":[{"title":"Crear cargas prefirmadas de archivos","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/files","href":"/es/api-reference/files-api/crear-cargas-prefirmadas-de-archivos"}]},{"group":"Custom attributes API","pages":[{"title":"Consultar atributos personalizados por workspaceId","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/settings/attributes","href":"/es/api-reference/custom-attributes-api/consultar-atributos-personalizados-por-workspaceid"}]},{"group":"Provider channels API","pages":[{"title":"Obtener canales de proveedores por workspace","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/provider-channels","href":"/es/api-reference/provider-channels-api/obtener-canales-de-proveedores-por-workspace"},{"title":"Obtener canales por workspace y tipo de proveedor","description":"Obtiene los canales de proveedores por identificador de workspace y tipo de proveedor.","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/provider-channels/{messageProviderType}","href":"/es/api-reference/provider-channels-api/obtener-canales-por-workspace-y-tipo-de-proveedor"}]},{"group":"LeadScout API","pages":[{"title":"Iniciar conversación saliente de LeadScout con un lead conocido","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/leadscout/outbound","href":"/es/api-reference/leadscout-api/iniciar-conversación-saliente-de-leadscout-con-un-lead-conocido"},{"title":"Solicitar transferencia manual de LeadScout a usuarios internos","description":"Solicita la transferencia manual de una conversación controlada por LeadScout a uno o más usuarios internos.\n\nLa solicitud se confirma con `202 Accepted`; la asignación se procesa de forma asíncrona. La respuesta repite los destinatarios solicitados y un ID de seguimiento para correlación. La resolución de usuarios internos (por ID o EMAIL) ocurre después y no se refleja en esta respuesta.","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/leadscout/conversations/{conversationId}/handoff","href":"/es/api-reference/leadscout-api/solicitar-transferencia-manual-de-leadscout-a-usuarios-internos"}]},{"group":"Templates API","pages":[{"title":"Descubrir las variables agnósticas de una plantilla","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/templates/{templateId}","href":"/es/api-reference/templates-api/descubrir-las-variables-agnósticas-de-una-plantilla"}]},{"group":"Internal Users API","pages":[{"title":"Obtener usuario interno por un identificador","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/users/lookup","href":"/es/api-reference/internal-users-api/obtener-usuario-interno-por-un-identificador"},{"title":"Obtener usuario interno por ID","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/users/{userId}","href":"/es/api-reference/internal-users-api/obtener-usuario-interno-por-id"},{"title":"Listar usuarios internos","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/users","href":"/es/api-reference/internal-users-api/listar-usuarios-internos"}]},{"group":"Agents API","pages":[{"title":"Listar los Agents de un workspace","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml get /bridge/api/v1/workspaces/{workspaceId}/agents","href":"/es/api-reference/agents-api/listar-los-agents-de-un-workspace"},{"title":"Iniciar conversación saliente con un Contact como Agent específico","deprecated":null,"version":null,"openapi":"/es/api-reference/openapi.yaml post /bridge/api/v1/workspaces/{workspaceId}/agents/{agentId}/outbound","href":"/es/api-reference/agents-api/iniciar-conversación-saliente-con-un-contact-como-agent-específico"}]}]},{"tab":"Webhooks","pages":[{"title":"Webhooks","href":"/es/webhooks"}]},{"tab":"Custom Connections","pages":[{"title":"Custom Connections","href":"/es/lead-capture"}]}]},{"language":"pt-BR","navbar":{"links":[{"href":"https://docs.bridge.new/pt-br/connect-your-agent","label":"Conectar IA"},{"href":"https://help.bridge.new","label":"Central de ajuda"},{"href":"mailto:support@sainapsis.com","label":"Falar com o suporte"}],"primary":{"type":"button","label":"Aplicativo Bridge","href":"https://app.bridge.new"}},"pages":[{"title":"pt-BR","href":"/pt-br"}]}]},"basePath":"","title":"Iniciar conversación saliente de LeadScout con un lead conocido - Bridge REST Integrations API \u0026 Webhooks","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}