Jotform

Consulte envios e perguntas de formulários do Jotform durante chamadas usando ferramentas de webhook.

Sua recepcionista pode verificar se um chamador enviou um formulário, como uma solicitação de cadastro ou reserva, e explicar o que um formulário pede.

Antes de começar

Valor	Onde encontrar
API key	Settings → API → Create New Key, com Read Access
Form ID	O número no fim da URL do formulário, por exemplo `form.jotform.com/241234567890123`

Use https://api.jotform.com abaixo se sua conta estiver nos EUA. Contas na UE usam https://eu-api.jotform.com, e contas HIPAA usam https://hipaa-api.jotform.com.

Consultar envios

Acesse Integrations, selecione Add integration e escolha Webhook Tool.

Campo	Valor
Name	`get_form_submissions`
Description	”Liste os envios recentes do nosso formulário de cadastro. Use quando um chamador perguntar se recebemos o formulário.”
Method	GET
URL	`https://api.jotform.com/form/FORM_ID/submissions`
Request Headers	`APIKEY`: sua chave de API
Query Parameters	`limit` (number, obrigatório): “Sempre 20.” `orderby` (string, obrigatório): “Sempre o valor exato `created_at`.”
Assign to agents	Receptionist

Selecione Enable. Sua recepcionista lê os 20 envios mais recentes e procura o nome ou número de telefone do chamador nas respostas.

Explicar o formulário

Crie uma segunda ferramenta de webhook com o mesmo cabeçalho.

Campo	Valor
Name	`get_form_questions`
Description	”Obtenha as perguntas do nosso formulário de cadastro. Use quando um chamador perguntar o que o formulário precisa.”
Method	GET
URL	`https://api.jotform.com/form/FORM_ID/questions`

Teste sua recepcionista perguntando se um envio recente foi recebido.

Limitações

Sua recepcionista não pode enviar formulários. A API do Jotform recebe envios como campos de formulário com nomes como submission[3], que as ferramentas de webhook não conseguem enviar. Para coletar detalhes em uma chamada, salve-os com outra ferramenta, como o Airtable ou um webhook para seu próprio sistema.

Solução de problemas

Problema	O que verificar
`You're not authorized`	Verifique a chave de API e use o host de API da região da sua conta.
Um envio não é encontrado	Ele pode ser mais antigo que os 20 mais recentes. Aumente o número na descrição de `limit`, mantendo a lista curta o suficiente para ler.
É difícil encontrar as respostas	Peça aos chamadores o nome ou e-mail exato que inseriram no formulário.