Webhooks

Webhooks permitem que o assistente interaja com sistemas externos e os integre ao seu workflow. Com webhooks, o assistente pode recuperar informações atualizadas (por exemplo, dados do cliente, produtos disponíveis ou horários livres) ou enviar/submeter informações coletadas (por exemplo, após um usuário concluir uma transação/reserva).

Como configurar webhooks

Webhooks podem ser configurados diretamente dentro de uma função/ação ativando o switch webhook e fornecendo a URL do webhook conforme mostrado abaixo:

O bot de voz enviará então os parâmetros extraídos como corpo da requisição em um POST.

Pós‑processamento

Se o webhook for usado para recuperar dados, às vezes é necessário transformar esses dados, por exemplo filtrar itens ou formatar valores.

Se for necessário pós‑processamento, o campo Post hook JS function call pode ser usado para especificar o nome de uma função que deve ser chamada logo após o webhook recuperar os dados.

O parâmetro da função será o corpo da resposta do webhook: um objeto JSON aninhado se o corpo for JSON válido; caso contrário, uma string (se o corpo não puder ser analisado como JSON).

Execução programática de webhooks

Webhooks também podem ser executados programaticamente a partir de qualquer trecho de código JavaScript a qualquer momento da seguinte forma:

function myFunction(params) {
    response = webhook("https://mydomain.com/apiEndpoint", {"sample": "data"});
    return response;
}

Parâmetros