Primeiros passos com o Lingara

Esta página é uma tradução do inglês. Se as duas diferirem, a página em inglês é a correta. Ler a página em inglês

Ligue o seu próprio servidor ou app à sua conta Lingara sem escrever uma integração de raiz. Escolhe uma receita, preenche alguns campos, verifica o resultado face às regras reais do Lingara e depois aplica-o. Os scripts são opcionais.

O que pode criar

Uma ligação é composta por quatro peças. Cada uma é aqui nomeada com as palavras da app, ao lado do termo que o Lingara usa para ela:

• Um início de sessão para o seu servidor (cliente OAuth). O seu servidor usa-o para agir na sua conta.
• Uma palavra-passe para esse início de sessão (segredo do cliente). Vê-a uma única vez, logo depois de aplicar.
• Mensagens para o seu servidor (endpoint de webhook). O Lingara envia uma mensagem ao seu servidor quando algo acontece, por exemplo quando um plano de lição fica pronto.
• Um cartão dentro do Lingara (manifesto de app). A sua app desenha um cartão na sua página Início ou Planos de lição.

Nunca tem de juntar estas peças à mão. Uma receita escolhe as peças e a sua ordem, e «Verificar» diz-lhe o que vai ser criado antes de qualquer coisa ser criada.

Avisar o meu servidor quando um plano de lição estiver pronto

Esta receita cria um início de sessão, a respetiva palavra-passe e as mensagens. Comece na app web e siga as palavras do assistente:

1. Em Apps e ligações, em «Criar uma ligação», prima «Começar a criar» e escolha «Avisar o meu servidor quando um plano de lição estiver pronto».
2. Em «Nome e capacidades», dê um nome ao início de sessão.
3. Em «Para onde enviar», indique o endereço https:// do seu servidor. Também pode abrir «Usar um script», colar o script abaixo e premir «Experimentar».
4. Em «Verificar», prima «Verificar» e leia «Eis o que vai ser criado».
5. Prima «Aplicar» e copie cada palavra-passe assim que aparecer. Cada uma é mostrada uma única vez.
6. Gere um plano de lição e veja o seu servidor receber lesson_plan.ready.

O script é opcional. Este faz o que os campos fazem e acrescenta a mensagem que o Lingara envia quando não foi possível criar um plano de lição:

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

E a seguir

• Receitas descreve as três receitas e o que fazer com o que cada uma cria.
• Testar, simular e aplicar explica o que «Verificar» verifica e o que «Aplicar» faz.
• Documentação para programadores do Lingara lista tudo o que um script pode chamar.
• Tudo o que uma ligação cria também pode ser criado à mão nas Ferramentas de programador, na app web.