URLs Únicos
- Sergio Santos (Unlicensed)
- Nicola Occhipinti
URLs únicos são usados para receber dados. Quando você precisa que alguém envie dados de volta ao aplicativo, você fornece a eles um URL único.
Ao gerar um URL e enviá-lo, o aplicativo está dizendo aos outros, para voltarem, enviarem os dados para este URL.
Isso é conveniente para receber dados de qualquer lugar e de qualquer pessoa. No entanto, conforme o nome especificado, o URL é único. Você precisará gerar um novo URL para cada recepção futura de dados. O URL expira após o uso ou o tempo esgotado (5 a 60 minutos, padrão: 10 minutos).
Um URL único consiste em 3 partes,
Papel | Descrição |
|---|---|
Parâmetros (opcional) | Para receber dados e mapeá-los para campos de aplicativos |
Formulários da Web (opcional) | Para coletar informações extras por meio de um formulário da web |
Página da Internet | Para exibir mensagens de confirmação de partes anteriores e chamar um subfluxo |
Note - Parameters and Web Forms sections are both optional. You are free to have a one-time URL only receiving data or only collecting data via a form.
Criar URL único
Siga as etapas 1 a 5 na captura de tela acima para editar o URL único.
Parâmetros
Na seção de parâmetros, você pode ver a área Sample Json Payload . É aqui que você informa ao aplicativo como são os dados a serem recebidos. Dessa forma, podemos especificar antecipadamente onde salvar os dados recebidos.
Você pode preencher o exemplo de carga útil JSON
coloque-o manualmente
ouça dados em tempo real
Por exemplo, na captura de tela acima, os dados JSON com 3 valores incluídos são inseridos manualmente.
Para obter dados em tempo real, clique no botão Ouvir dados e copie o URL de amostra para teste. O URL único oferece suporte aos métodos GET e POST.
Faça um teste ao vivo e anexe este URL de exemplo. Por exemplo, no seu navegador, visite:
Você verá uma página em branco ao clicar em retornar, pois ainda não criou a página da Web de confirmação .
Volte para a janela Ouvir carga útil após o teste e clique em "Concluído":
Você verá seus dados em tempo real recebidos na área de carga útil JSON de amostra.
Clique em Preview Payload e vamos mapeá-los para os campos do aplicativo:
Para mapear dados:
clique nos dados na área de dados de amostra do lado esquerdo
O caminho JSON aparece no lado direito
crie um novo campo digitando um novo nome e clique no novo nome ou pesquise um campo existente
clique no botão Adicionar para adicionar à lista de mapeamento
Formulários da Web
Clique em Adicionar item para começar a adicionar entradas do formulário web.
Parâmetros | Descrição |
|---|---|
Nome único | Único em todas as entradas de autenticação, não é possível inserir um espaço. Use sublinhados ou hífens para separar palavras |
Tipo | Escolha String para texto sem retornos de carro, Número para números inteiros ou flutuantes, Texto para texto com retornos de carro, Selecione para entrada de origem estática ou dinâmica |
Título | O título é exibido na interface do usuário |
Obrigatório? | Esta entrada é obrigatória? caso contrário, desligue e forneça um valor padrão, se necessário |
Salvar no campo do aplicativo | Especifique onde armazenar o valor. Crie um novo campo de aplicativo aqui mesmo, digitando um novo nome de campo e selecionando um tipo de campo no pop-up ou pesquise um campo existente |
Espaço reservado | O prompt cinza é exibido na caixa de entrada |
Descrição | O prompt preto é exibido abaixo da caixa de entrada |
Adicione quantas entradas de formulário da web forem necessárias e clique em Salvar quando terminar. Dê uma olhada na área de visualização .
Página da Internet
Crie uma página da web simples para exibir mensagens de confirmação.
Escolha um tempo de expiração de URL para seu link único de 5 a 60 minutos. Por padrão, o link expira em 10 minutos.
Por fim, selecione um subfluxo para ser executado após a exibição da página da web.
Normalmente, disparamos um gatilho neste subfluxo, para notificar os chatbots sobre a atualização.
Gerar URL único
Use uma etapa de ação para gerar o URL e salvá-lo em um campo do aplicativo para enviar mais tarde.