[Exemplo] Enviando dados para Airtable (POST)

Dados coletados dentro dos bots frequentemente são enviados para um banco de dados externo. Uma maneira fácil de fazer isso é integrando com Airtable. Airtable é uma ferramenta que permite criar uma planilha com a qual você pode se comunicar via API.

Por favor, note que o termo estado do diálogo refere-se à mesma coisa que bloco, no contexto de ferramentas de desenvolvimento.

Neste tutorial configuraremos uma integração com o Airtable. Por causa de todo o código parece bastante técnico, mas na verdade é bem fácil.

Se você é novo no uso de variáveis no Chatlayer.ai, siga este o tutorial primeiro.

• Comece construindo um fluxo curto que você use para coletar alguns dados sobre seu usuário, por exemplo:

• Este fluxo adiciona as variáveis "customerType" e "firstName" à sessão do usuário.

• Configure um Airtable que tenha uma coluna para cada variável que você deseja salvar. Linhas serão adicionadas para cada cliente.

Neste tutorial, usaremos este Airtable. Fique à vontade para reutilizá-lo!

• No ponto do fluxo onde você deseja enviar os dados para o Airtable, adicione uma Ação contendo um plugin de Código.

Quer aprender mais sobre as possibilidades do plug-in de Código? Você pode encontrá-lo aqui.

• No nosso exemplo, queremos enviar o tipo do cliente e o primeiro nome. Além disso, queremos pular para outro diálogo do bot assim que os dados forem enviados. Comece adicionando esses parâmetros no topo do seu editor de código.

• Em seguida, adicione o código abaixo ao plugin e salve seu diálogo de Ação.

const body = {
    "records": [{
        "fields": {
            "First Name": args.firstName,
            "Customer Type": args.customerType
        }
    }]
}
const airtableResult = await fetch('https://api.airtable.com/v0/(yourAppId)/(yourTableName)', {
    method: 'POST',
    body: JSON.stringify(body),
    headers: {
        'Authorization': 'Bearer (insert token here)',
        'Content-Type': 'application/json'
    }
}).then(r => r.json())

ChatlayerResponseBuilder()
    .setNextDialogState(args.nextDialogState)
    .send()

Lembre-se de obter o id do app, o nome da tabela e o token bearer corretos para o seu Airtable. Você pode encontrá-los aqui.

• Et voilà! Agora, toda vez que um usuário passar pelo seu fluxo, seus dados serão enviados para o Airtable e ele continuará para o diálogo de bot Success.

• Se houver quaisquer erros com sua conexão ao Airtable, você pode encontrá-los na aba de Logs de Erro no Chatlayer.ai.