Templates/Meus Templates/Apps/Meus NicoApps (Mini-Apps)/Mini-Apps 2.0/URLs Únicos

URLs Únicos

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.

2026-08-11

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

Nota

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.