Skip to main content
POST
Generar respuesta de IA
API de Famulor 1.0 (legado). Esta página se aplica únicamente a Famulor 1.0 (app.famulor.de) y se conserva por compatibilidad. Para la plataforma actual, usa la referencia de la API de Famulor 2.0.
Este endpoint genera automáticamente una respuesta inteligente a un mensaje de cliente usando tu asistente de IA configurado. El sistema gestiona automáticamente el contexto de la conversación de cada cliente, de modo que el asistente recuerda los mensajes anteriores y puede responder de forma contextual. Ideal para integrarlo en plataformas de mensajería externas, CRM o interfaces de chat personalizadas.
Límite de frecuencia: este endpoint está limitado a 5 solicitudes por minuto por token de API para evitar abusos.

Cuerpo de la solicitud

integer
requerido
El ID del asistente que se usará para generar la respuesta. Debe pertenecer a tu cuenta.
string
requerido
Un identificador único del cliente. Se usa para mantener el contexto de la conversación a lo largo de varios mensajes.Ejemplos: número de teléfono, dirección de correo electrónico, ID de contacto del CRM, ID de usuario de Facebook.Longitud máxima: 255 caracteres.Importante: usa siempre el mismo formato para el mismo cliente, de modo que el contexto se asocie correctamente.
string
requerido
El mensaje del cliente al que se va a responder.
object
Variables de contexto opcionales que se pasan al asistente. Se combinan con las variables de conversación existentes.Útil para pasar datos del cliente, contexto de sesión u otros metadatos que permitan personalizar la respuesta.

Campos de la respuesta

boolean
Indica si la solicitud se realizó correctamente
string
El UUID de la conversación. Úsalo para hacer seguimiento o referenciar la conversación más adelante.
string
El identificador de cliente proporcionado en la solicitud
string
La respuesta generada por la IA para el mensaje del cliente
array
Array de llamadas a función que hizo el asistente al procesar el mensaje. Array vacío si no se llamó a ninguna función.
boolean
Indica si las respuestas de IA están desactivadas para esta conversación (p. ej., por una intervención manual)

Respuestas de error

boolean
Será false cuando se produzca un error
string
Mensaje de error que describe lo que ha fallado
string
Código de error legible por máquina. Valores posibles:
  • ASSISTANT_NOT_FOUND - el ID del asistente no es válido o no pertenece a tu cuenta
  • INSUFFICIENT_BALANCE - el saldo de tu cuenta es insuficiente para procesar el mensaje

Casos de uso

Respuestas de IA multicanal

Usa este endpoint para añadir respuestas de IA a cualquier plataforma de mensajería:
  1. Recibe un mensaje de WhatsApp, Facebook, SMS u otro canal
  2. Llama a este endpoint con el mensaje y el identificador de cliente
  3. Envía la respuesta de la IA de vuelta por el canal original

Integración con CRM

Integra respuestas de IA en tu CRM o sistema de helpdesk:
  • Usa el ID de contacto del CRM como customer_identifier
  • Pasa datos del cliente como variables para respuestas personalizadas
  • La conversación persiste entre sesiones cuando se usa el mismo identificador

Interfaces de chat personalizadas

Crea tu propia interfaz de chat impulsada por tu asistente de Famulor:
  • Genera un identificador único para cada sesión de usuario
  • Envía mensajes a través de este endpoint
  • Muestra las respuestas de la IA en tu interfaz

Persistencia de la conversación

Las conversaciones se almacenan automáticamente según la combinación de assistant_id y customer_identifier:
  • Mismo identificador: los mensajes se añaden a la conversación existente, manteniendo el contexto completo
  • Identificador nuevo: se crea una nueva conversación para el cliente
  • Combinación de variables: cuando se proporcionan variables, se combinan con las variables de conversación existentes

Buenas prácticas

  • Usa identificadores consistentes: usa siempre el mismo formato para los identificadores de cliente (p. ej., siempre E.164 para números de teléfono)
  • Pasa contexto relevante: usa el campo variables para proporcionar datos del cliente que ayuden a la IA a personalizar las respuestas
  • Gestiona los límites de frecuencia: implementa lógica de reintento con retroceso exponencial para las solicitudes limitadas por frecuencia
  • Guarda los ID de conversación: guarda el conversation_id devuelto para referencia o depuración posterior
  • Supervisa los costes: haz seguimiento del uso para gestionar los costes, especialmente en integraciones de alto volumen