El Wiring Lab

El Wiring Lab es donde conectas una persona a un motor. Esa conexión se llama un enlace — empareja exactamente una persona con un motor, para que el motor funcione con la voz de esa persona. Cada enlace tiene su propio api_slug, un identificador único para ese cableado específico, para que la plataforma siempre sepa a qué combinación de persona y motor pertenece una solicitud.

Para cablear un enlace:

Abre el Wiring Lab y elige la persona que quieres poner en línea.
Arrastra un motor desde la biblioteca al lienzo para asignarlo a esa persona.
Pulsa Guardar (el botón Confirmar Cableado) para persistir el enlace. Hasta que lo confirmes, el cableado no se guarda.

Puedes cablear varios enlaces persona-motor en una cuenta — cada uno es su propia conexión con su propio api_slug.

Claves API

Una clave API es la forma en que un bot externo o integración se autentica en FluidTalk. Hay dos maneras de crear una:

Crear — genera una clave simple para toda la cuenta, a nivel de cuenta , que aún no está vinculada a ninguna persona ni motor.
Provisionar — genera una clave que está vinculada a una persona y motor específicos en un solo paso. Esta es la ruta recomendada , porque una clave ya vinculada está lista para servir tráfico en vivo.

Gestionas las claves desde el Wiring Lab:

Vincular / delimitar una clave — asigna una clave existente a nivel de cuenta a una persona y motor (y opcionalmente renómbrala). Una clave que nunca se delimita no puede servir llamadas en vivo.
Listar — ver todas las claves de la cuenta.
Revocar — elimina una clave para que ya no pueda usarse.

Atención

El secreto de una clave API se muestra solo una vez, en el momento en que se crea. Cópialo entonces y guárdalo en un lugar seguro — si lo pierdes, no puedes verlo de nuevo. Simplemente revoca esa clave y crea una nueva.

Atención

Una clave debe estar vinculada a una persona (y motor) antes de poder servir tráfico en vivo. Una clave sin delimitar, a nivel de cuenta, es rechazada en llamadas en vivo — provisiona una clave delimitada, o vincula una existente, primero.

Lista de verificación para ir en vivo

Cuando los cuatro son verdaderos, estás en vivo:

Persona lista — identidad y fotos configuradas.
Motor vinculado — el motor cableado a esa persona y confirmado en el Wiring Lab.
Una clave API delimitada — provisionada (o vinculada) a esa persona y motor exactos.
Apunta tu bot al handshake — tu integración envía cada mensaje entrante al endpoint de handshake en vivo, pasando la clave en el encabezado X-API-Key . FluidTalk responde con el siguiente mensaje y la acción a tomar.

Para los endpoints exactos, campos de solicitud y respuestas, consulta la Referencia de la API para desarrolladores.

Consejo

No tienes que ir en vivo para probarlo. Ejecuta toda la conversación en el simulador integrado primero — el mismo motor, sin clave ni tráfico real — y luego cabléalo cuando se comporte como quieres.

Atención

El servicio en vivo requiere un plan de pagoactivo. Una cuenta gratuita o vencida es rechazada en el handshake, así que tu bot deja de servir en el momento en que el plan termina. Ver Facturación y planes.

Guías relacionadas

Constructor de motores — diseña la conversación antes de cablearla.
Pruebas en el simulador — prueba el motor de principio a fin sin clave.
Referencia de la API para desarrolladores — las llamadas de handshake y encabezados exactos.
Facturación y planes — qué desbloquea un plan de pago para el servicio en vivo.