Mostrar eventos no próprio website (feed de eventos)

É possível disponibilizar eventos individuais num feed JSON público e sem chave, alimentando assim o calendário do próprio website a partir do Univents — incluindo o preço «A partir de» e o aviso de «Esgotado».

Para mostrar os eventos também no próprio website — com design próprio, e não como página incorporada do Univents —, é possível disponibilizar eventos individuais para esse efeito. O Univents fornece-os então através de um feed público e só de leitura, que o website (ou o da agência) pode consultar e apresentar à sua maneira.

Mostrar um evento no website

A disponibilização é feita diretamente no evento, e não de forma centralizada num único local:

  1. Abrir o evento pretendido.
  2. Clicar, no cabeçalho da vista de detalhe, no interruptor Mostrar no website.
  3. O Univents guarda a alteração de imediato e confirma com uma mensagem breve.

Com o interruptor ativo, o evento aparece no feed em poucos minutos. Se o interruptor for desativado ou o evento for eliminado, o evento desaparece igualmente do feed de forma automática. O interruptor aplica-se apenas a esse evento — não existe disponibilização em massa para todos os eventos de uma só vez.

O interruptor também pode ser ativado pelo assistente de IA, por exemplo com «Mostra a festa de verão no nosso website». O assistente pergunta primeiro, porque os dados ficam depois acessíveis publicamente. Também antes de alterar o nome, o texto curto ou a descrição de um evento que aparece no teu website, o assistente mostra-te uma confirmação com o evento, a data e o novo texto. Nada é guardado até confirmares.

Se um evento estiver disponibilizado mas ainda não tiver texto curto, aparece junto ao interruptor o aviso Falta ainda um texto curto para a vista de lista. O aviso não bloqueia nada — o evento aparece no feed na mesma.

O que consta no feed

O feed fornece exclusivamente dados pensados para uma apresentação pública em calendário: título, descrição, texto curto para a vista de lista, hora de início e de fim, se a data já é definitiva, local do evento, imagem de capa, etiquetas, uma ligação para a venda de bilhetes (se o evento tiver uma página de bilhetes publicada – em rascunho não há ligação nem preço), bem como o preço de bilhete mais baixo ainda disponível e um aviso de «Esgotado». Dados internos como orçamento interno, número de convidados, notas, dados de contacto, estado ou dados financeiros nunca constam no feed, independentemente de o evento estar público ou não. Também os contingentes, os nomes das categorias e os números de vendas ficam internos — para o exterior segue apenas o preço e a informação «Esgotado: sim/não».

Preço «A partir de» e Esgotado

Quem vende bilhetes através do Univents recebe no feed dois dados adicionais, a partir dos quais o website pode construir um «A partir de 25 €» e um «Esgotado»:

  • price_from — o preço de bilhete mais baixo que um visitante ainda pode comprar neste momento, como valor com IVA (ou seja, o que consta na categoria na loja de bilhetes). Se a categoria mais barata estiver esgotada, passa automaticamente a valer a seguinte, mais cara. Assim, o website nunca promete um preço que já não existe na loja.
  • price_from_currency — a moeda do workspace sob a forma de código, p. ex. EUR ou CHF.
  • tickets_sold_out — true assim que nenhuma categoria de bilhetes puder ser comprada. Enquanto alguma categoria ainda tiver bilhetes, o valor mantém-se false, mesmo que categorias individuais já estejam cheias.

Se tudo estiver esgotado, price_from fica vazio (null) — um preço «A partir de» ao lado de «Esgotado» convidaria a uma compra que não é possível. Um evento sem venda de bilhetes devolve price_from: null e tickets_sold_out: false: não vende nada, logo também não está esgotado.

Se um bilhete for anulado, o lugar fica de imediato livre — a categoria volta a poder ser comprada e volta a entrar no preço «A partir de». Como o feed é guardado brevemente em cache, um evento que acabou de esgotar pode ainda aparecer como disponível no website durante alguns minutos.

Texto curto ou descrição?

Muitos websites mostram os eventos duas vezes: como cartão curto numa lista e em detalhe numa página própria. Para a lista, a descrição completa é muitas vezes demasiado longa. Para isso existe o Texto curto para o website:

  1. Abrir o evento e clicar em Editar evento.
  2. Logo abaixo da Descrição encontra-se o campo Texto curto para o website.
  3. Introduzir uma ou duas frases (no máximo 280 caracteres, sem formatação) e guardar.

O feed fornece o texto curto num campo próprio, short_description — na lista e na vista individual. A descrição mantém-se inalterada e consta na íntegra no campo description. Que texto o website mostra e onde é decisão do próprio website: normalmente o texto curto na lista e a descrição na página de detalhe.

Se não houver texto curto, short_description fica vazio (null). O Univents nunca encurta a descrição automaticamente nem a usa como substituto — caso contrário, uma frase cortada apareceria no website sem ter sido pedida. Para eventos sem texto curto, o feed não sofre, portanto, qualquer alteração.

Ao copiar um evento e ao criar uma série de datas, o texto curto é copiado, tal como a descrição. Na importação de Excel, a coluna chama-se Texto curto.

Imagem e descrição: evento, não página de bilhetes

Para o calendário do website contam a imagem e a descrição do próprio evento — ou seja, o que é mantido no evento em Apresentação. A imagem e a descrição de uma página de reservas ou de bilhetes pertencem a essa página e não são transferidas automaticamente para o calendário do website. Ambas as coisas são intencionais: muitos negócios mostram, de propósito, uma imagem diferente na loja de bilhetes e no calendário do próprio website.

Para ter ambas iguais, é preciso indicá-lo uma vez:

  1. Abrir a página de reservas ou de bilhetes e, nela, a secção Detalhes.
  2. Sob a imagem e a descrição encontra-se o aviso com o botão Aplicar também ao calendário do site.
  3. Confirmar a pergunta. A imagem e a descrição da página são então transferidas para o evento associado; os dados lá guardados até então são substituídos.

O botão só aparece se a página estiver associada a um evento (nas páginas de bilhetes é sempre o caso). É aplicado o último estado guardado da página, e os campos que estejam vazios na página permanecem inalterados no evento — uma página vazia nunca elimina, portanto, uma imagem. Até a alteração chegar ao calendário do website podem passar alguns minutos, porque o feed é guardado brevemente em cache.

A dimensão com que a imagem aparece é definida pelo website — o Univents fornece a imagem no tamanho original.

Consultar o feed

O feed é público e pode ser consultado sem início de sessão nem chave de API — um website ou uma ferramenta externa pode carregá-lo diretamente com fetch:

GET https://univents.app/api/public/dein-workspace/events
GET https://univents.app/api/public/dein-workspace/events/{eventId}

dein-workspace é o slug do workspace, que também se encontra na barra de endereço do browser, a seguir a /home/. Com os parâmetros from e to delimita-se o período e com limit o número de resultados (predefinição 50, máximo 100). O limit é arredondado para três níveis — 25, 50 ou 100 —, para que a cache funcione com poucas respostas: um valor pedido é sempre arredondado para o nível seguinte, p. ex. ?limit=10 devolve 25 entradas, tal como ?limit=25, e tudo o que exceda 100 é limitado a 100. Sem indicação, o feed devolve todos os eventos disponibilizados a partir de hoje.

Um exemplo de resposta tem este aspeto:

{
  "workspace": "dein-workspace",
  "count": 2,
  "events": [
    {
      "id": "…",
      "title": "Sommerkonzert",
      "description": "…",
      "short_description": "Open Air im Hof, Eintritt frei",
      "start": "2026-08-20T18:00:00Z",
      "end": "2026-08-20T23:00:00Z",
      "date_is_confirmed": true,
      "venue": "Großer Saal",
      "image_url": "https://…",
      "tags": ["Konzert"],
      "ticket_url": "https://univents.app/book/dein-workspace/deine-seite",
      "price_from": 25,
      "price_from_currency": "EUR",
      "tickets_sold_out": false,
      "updated_at": "2026-08-05T09:00:00Z"
    }
  ]
}

Para programadores e agências

O feed foi concebido de propósito para se integrar diretamente num website existente, sem ser necessário gerir credenciais:

  • Sem autenticação, sem chave de API — a rota é publicamente acessível, mas devolve exclusivamente eventos do respetivo workspace com o interruptor ativado.
  • CORS aberto — uma consulta com fetch funciona diretamente a partir do browser de qualquer website.
  • Em cache — as respostas ficam em cache durante pouco tempo (alguns minutos), para que consultas frequentes continuem rápidas. Um evento recém-disponibilizado não aparece, por isso, de imediato, mas sim em poucos minutos.
  • Com limite de pedidos — perante um número muito elevado de consultas num curto espaço de tempo a partir da mesma origem, a rota responde com um erro em vez de dados vazios; para a utilização normal de um website, isto não é relevante.
  • Um slug de workspace desconhecido devolve um erro, não uma lista vazia — assim nota-se logo quando o slug está errado.

Perguntas frequentes

O feed mostra também espaços que estão apenas ocupados, mas não publicados? Não. O feed mostra exclusivamente eventos em que o interruptor Mostrar no website foi ativado — nunca a ocupação geral dos espaços.

O feed contém preços? Sim, um: o preço de bilhete mais baixo ainda disponível (price_from, com IVA) juntamente com a moeda. A lista de preços completa continua a constar apenas na página de reservas para a qual aponta ticket_url.

Porque é que o meu website mostra um preço mais alto do que ontem? Porque entretanto a categoria mais barata esgotou. O feed indica sempre o preço mais baixo que ainda se pode comprar — não o mais baixo que alguma vez existiu.

Porque é que o meu evento sem bilhetes não indica «Esgotado»? Porque não vende bilhetes. tickets_sold_out só é true quando existe venda de bilhetes e já não resta nada.

É obrigatório preencher um texto curto? Não. O texto curto é facultativo. Sem ele, o feed devolve short_description: null e o website mostra o que mostrava até agora.

O texto curto também é apresentado na página de reservas ou de bilhetes? Não. O texto curto destina-se apenas ao feed do website. Não aparece no orçamento, no Function Sheet, na página de reservas nem no portal do cliente.

É preciso disponibilizar cada evento individualmente? Sim, atualmente não existe disponibilização em massa. O interruptor encontra-se propositadamente em cada evento, para haver controlo total sobre o que fica visível publicamente.

A funcionalidade está associada a um plano específico? Sim, à área de Eventos: esta existe a partir do plano Core, e com ela o interruptor Mostrar no website. Para além disso, não é necessário mais nada. O feed mostra exclusivamente o que for disponibilizado pelo próprio utilizador.

A consulta do feed tem custos? Não, o feed é um acesso apenas de leitura a dados já disponibilizados — não há custos adicionais.

Newsletter Univents

Novidades do produto e dicas práticas para empresas de eventos e catering. Cerca de uma vez por mês, não mais.

A newsletter é enviada em inglês.

Temas