Llama a un servicio vinculado

Los servicios vinculados se invocan desde las acciones del asistente en el cliente —un formulario conectado al proxy o una acción de plantilla personalizada— mediante el helper executeProxyRequest:

executeProxyRequest(id, body, callback, params)

• id: el Service ID que registraste.
• body: el payload JSON que se envía. Se usa como cuerpo de la petición en POST y PUT;

las peticiones GET y DELETE se envían sin cuerpo.

• callback: recibe la respuesta del endpoint para que tu acción pueda mostrarla.
• params (opcional): valores que rellenan los marcadores {{params.x}} de la URL y las

cabeceras del servicio. Consulta Pasar valores dinámicos.

Desde un formulario

Para un formulario cuyo propósito es llamar a un endpoint, conecta su envío a sendProxyForm, que serializa los campos y llama a executeProxyRequest por ti:

sendProxyForm(proxyId, event, callback)

Pasa el Service ID como proxyId. Los campos enviados se convierten en el cuerpo de la petición y la respuesta se añade a la conversación. Consulta Formularios del asistente para crear el formulario y Personalización avanzada para conectar su manejador.

Desde una acción personalizada

En un helper de plantilla personalizado puedes llamar directamente a executeProxyRequest(id, body, callback) —por ejemplo, para obtener datos cuando el usuario hace clic en un botón— y usar la respuesta para actualizar la conversación. El helper está documentado en Personalización avanzada.

Documentación relacionada

• Personalización avanzada: helpers, acciones y plantillas.
• Formularios del asistente: recoge los datos que necesita la llamada a un servicio.