Custom Widget Privado: Como criar e registrar um widget personalizado no Jotform

Olá, equipe Jotform.

Preciso criar um Custom Widget privado para minha conta.

O widget será hospedado em uma URL HTTPS externa e deve funcionar como um campo real do formulário, salvando o valor na submissão por meio da Custom Widget API / JFCustomWidget.

O caso de uso é validar um CNPJ brasileiro, consultar uma API pública e retornar dados como razão social, situação cadastral, município e UF.

Não encontrei mais na interface a opção para “Add Widget”, “Create Widget”

Vocês podem me orientar qual é o caminho atual para registrar um Custom Widget privado na minha conta ou habilitar esse recurso?

Hi Portabilis,

Thanks for reaching out to Jotform Support. I'm an AI assistant here to assist you.

Hoje, para registrar e usar um Custom Widget (incluindo widgets privados hospedados em URL HTTPS externa usando a API JFCustomWidget), o fluxo começa pela área de desenvolvedores de widgets.

De forma geral, você cria e registra o widget na área de desenvolvedores e, depois disso, ele passa a aparecer na lista de widgets para ser adicionado como qualquer outro campo do formulário.

Vou te mostrar o caminho atual:

Etapa 1 – Acessar a área de desenvolvimento de widgets

1. Acesse a página de Jotform API Widgets.
2. Nessa página, você encontra exemplos e instruções para criar um widget usando a API de widgets (incluindo uso de HTML, CSS, JavaScript e chamadas externas).
3. Siga as instruções da página para estruturar seu widget (frontend hospedado na sua URL HTTPS e integração via API de widget).

Etapa 2 – Registrar o widget

1. Na mesma área de desenvolvedores, use a opção de registrar o widget (Register Widget) conforme descrito na documentação da página.
2. Durante o registro, você informa os dados do widget (nome, descrição, URL HTTPS onde ele está hospedado, etc.).
3. Concluído o registro, o widget fica disponível na sua conta para ser usado nos formulários, de acordo com as configurações definidas (incluindo comportamento de campo e salvamento de valor via API JFCustomWidget).

Etapa 3 – Adicionar o widget ao formulário

1. Abra seu formulário em Form Builder e clique em Add Element no lado esquerdo da página.
2. Na aba Widgets, pesquise pelo nome do widget que você registrou.
3. Clique no widget ou arraste e solte para dentro do formulário.
4. Clique no ícone de varinha (Widget Settings) para configurar as opções específicas do widget, se houver.
5. Se necessário, use também o ícone de engrenagem (Question Properties) para ajustar propriedades adicionais do campo.

Para referência geral sobre adicionar widgets ao formulário, você também pode consultar a página de Online Form Widgets, onde é possível navegar pelos widgets e, a partir dela, acessar a opção de adicionar/registrar novos widgets.

Se, ao seguir esse caminho, alguma etapa específica (como o botão de registro) não aparecer para você, descreva exatamente o que está vendo na tela ou envie um print, para que nossa equipe possa analisar o caso em detalhes.

Reach out again if you need any other help.

O problema é que a etapa 2 (link: https://www.jotform.com/widgets/#add-widget) não está funcionado, ao invés de abrir para eu registrar o meu widget ele abre apenas a glaeria.

Hi Portabilis,

Entendi, obrigado por detalhar o que acontece com o link.

Atualmente, para criar/registrar um Custom Widget, a informação disponível é que você deve usar a página de Jotform API Widgets e seguir as instruções ali para criar o widget (HTML/JS/CSS, etc.). No conteúdo que tenho acesso, não há detalhes adicionais ou atualizados sobre o comportamento específico do link /widgets/#add-widget nem sobre outra forma alternativa de abrir diretamente a tela de registro quando esse link só mostra a galeria.

Como não há mais informações disponíveis sobre esse comportamento ou sobre uma possível mudança na forma de registrar widgets privados, eu não sei essa informação e nossa equipe de suporte vai cuidar do seu pedido.

Reach out again if you need any other help.

Hi Portabilis,

Our Portuguese Support agents are busy helping other Jotform users right now, so I'll try to help you in English using Google Translate, but you can reply in whichever language you feel comfortable using. Or, if you'd rather have support in Portuguese, let us know and we can have them do that. But, it might take a while until they're available again.

Now, coming back to your question, you should be able to register a new widget by clicking the Add New widget button at the lower right side of the gallery. Take a look at the screenshot below to see my results:

If you encounter any error, just share a screenshot with us and we will check on it. Our guide on How to Post Screenshots to Our Help Center will help you do that.

Reach out again if there’s anything else we can help you with.

Hi,

Thank you for your help.

It worked! I was able to find the Add New Widget button and register the custom widget successfully.

Thanks again for the support.

Hi Portabilis,

Sua solicitação foi respondida e o tópico está encerrado.

If you have another question or need more help, feel free to reply here and we'll assist you right away.