Primeros pasos con Lingara

Esta página está traducida del inglés. Si ambas difieren, la página en inglés es la correcta. Leer la página en inglés

Conecta tu propio servidor o app a tu cuenta de Lingara sin escribir una integración desde cero. Eliges una receta, rellenas unos pocos campos, compruebas el resultado con las reglas reales de Lingara y luego lo aplicas. Los scripts son opcionales.

Qué puedes crear

Una conexión se compone de cuatro piezas. Cada una se nombra aquí con las palabras de la app, junto al término que Lingara usa para ella:

• Un inicio de sesión para tu servidor (cliente OAuth). Tu servidor lo usa para actuar en tu cuenta.
• Una contraseña para ese inicio de sesión (secreto del cliente). La ves una sola vez, justo después de aplicar.
• Mensajes a tu servidor (endpoint de webhook). Lingara envía un mensaje a tu servidor cuando ocurre algo, como que un plan de lección esté listo.
• Una tarjeta dentro de Lingara (manifiesto de app). Tu app dibuja una tarjeta en tu página de Inicio o de Planes de lección.

Nunca tienes que juntar estas piezas a mano. Una receta elige las piezas y su orden, y «Comprobarlo» te dice lo que se creará antes de que se cree nada.

Avisar a mi servidor cuando un plan de lección esté listo

Esta receta crea un inicio de sesión, su contraseña y los mensajes. Empieza en la app web y sigue las palabras del asistente:

1. En Apps y conexiones, bajo «Crea una conexión», pulsa «Empezar a crear» y elige «Avisar a mi servidor cuando un plan de lección esté listo».
2. En «Nombre y capacidades», ponle nombre al inicio de sesión.
3. En «Adónde enviarlo», indica la dirección https:// de tu servidor. También puedes abrir «Usar un script», pegar el script de abajo y pulsar «Probarlo».
4. En «Comprobar», pulsa «Comprobarlo» y lee «Esto es lo que se creará».
5. Pulsa «Aplicar» y copia cada contraseña en cuanto aparezca. Cada una se muestra una sola vez.
6. Genera un plan de lección y observa cómo tu servidor recibe lesson_plan.ready.

El script es opcional. Este hace lo mismo que los campos y añade el mensaje que Lingara envía cuando no se pudo crear un plan de lección:

return lingara.webhook({ client: input.client, url: input.url, events: ['lesson_plan.ready', 'lesson_plan.failed'] })

Qué sigue

• Recetas describe las tres recetas y qué hacer con lo que crea cada una.
• Probar, simular y aplicar explica qué comprueba «Comprobarlo» y qué hace «Aplicar».
• Documentación para desarrolladores de Lingara enumera todo lo que un script puede llamar.
• Todo lo que crea una conexión también puedes crearlo a mano en Herramientas para desarrolladores, en la app web.