Visão geral das integrações

Depois de ler este artigo, sabe como se orientar no diretório de integrações, que integrações estão disponíveis atualmente, quais estão em preparação e o que cada uma faz pelo seu dia a dia de trabalho.

Em Integrações, liga serviços externos ao seu workspace Univents — desde o processamento de pagamentos, passando pela sincronização de calendário e e-mail, até à exportação DATEV para a contabilidade e aos acessos para automatizações próprias.

A página é um diretório: cada integração tem o seu próprio cartão e, ao clicar nele, abre-se a página de detalhe correspondente com todas as definições.

Como se orientar no diretório

Navegue na barra lateral esquerda até Integrações. Chega à página Todas as integrações, com todos os cartões.

  • À esquerda, a barra «Categorias» — Todos, Contabilidade, Pagamentos, E-mail e calendário, IA e Programadores, cada uma com o número de integrações ao lado. Um clique filtra os cartões; permanece na visão geral, a página não muda.
  • A categoria selecionada aparece na barra de endereço — pode, por isso, partilhá-la como ligação, por exemplo com uma colega que só deva ver as ligações de contabilidade.
  • Campo de pesquisa no topo (Pesquisar integração) — escreva o nome de um fornecedor ou uma palavra-chave para saltar diretamente para o cartão certo.
  • No telemóvel, a barra de categorias abre e fecha como uma fila de chips por cima dos cartões.
  • Clicar num cartão abre a página de detalhe da integração. No canto superior esquerdo, ← Todas as integrações leva-o de volta ao diretório em qualquer altura.

O que um cartão diz num relance

  • Ponto verde com «Ligado» — a integração está configurada e ativa neste workspace.
  • Selo «Brevemente disponível» — o fornecedor está em preparação e ainda não pode ser ligado.
  • Selo de plano na forma Desde Core ou Desde Growth — a integração ainda não está incluída no seu plano atual. Na página de detalhe encontra a opção de upgrade.

A isto juntam-se os botões do cartão:

  • Abrir leva à página de detalhe — é lá que liga e configura a integração.
  • Manifestar interesse surge em vez de «Abrir» em todos os cartões que ainda estão em preparação.
  • Guia abre o artigo de ajuda correspondente, sem ter de o procurar aqui.

O que está disponível atualmente

IntegraçãoCategoriaO que faz
StripePagamentosOs clientes pagam diretamente online numa reserva online
CalendárioE-mail e calendárioSincronização bidirecional com Google Calendar ou Microsoft Outlook
Caixa de entrada de e-mailE-mail e calendárioEspelhar uma caixa Gmail, Outlook ou IMAP no Univents
Entrada de e-mailE-mail e calendárioOs e-mails reencaminhados tornam-se automaticamente pedidos
Ligações do ClaudeIAUtilizar o Univents como ferramenta no Claude
Chave de APIProgramadoresChaves para a API REST e para automatizações próprias
DATEVContabilidadeExportar faturas emitidas como lote de lançamentos (exportação por ficheiro)
BMDContabilidadeExportar faturas emitidas como lote de lançamentos (exportação por ficheiro)
sevdeskContabilidadeTransferir faturas e contactos de clientes com um clique
bexioContabilidadeTransferir faturas e contactos de clientes com um clique
Lexware OfficeContabilidadeTransferir faturas e contactos de clientes com um clique

O que está em preparação

Em Contabilidade, vê ainda um cartão para BuchhaltungsButler. Tem a indicação Brevemente disponível e atualmente não pode ser ligado — nem através do suporte.

O que pode fazer: clique em Manifestar interesse no cartão. Entraremos em contacto assim que a ligação estiver pronta. Até lá, há cinco outras vias para a contabilidade: a exportação DATEV e a exportação BMD como ficheiro, ou sevdesk, bexio e Lexware Office como transferência direta — veja a secção «Contabilidade» mais abaixo.

Pagamentos — Stripe

Abra o cartão Stripe. Com o Stripe ativo, os clientes podem pagar diretamente numa reserva online; as receitas são transferidas automaticamente para a conta bancária indicada.

  • Clique em Ligar com o Stripe para iniciar o onboarding do Stripe. Será redirecionado para o site do Stripe.
  • Se já iniciou o onboarding mas ainda não o concluiu, vê o botão Continuar onboarding.
  • Com a ligação ativa, o Univents mostra o selo Ativo junto à entrada do Stripe. Com Desligar, pode terminar a ligação em qualquer altura.

O guia completo encontra-se no artigo Ligar a integração de pagamentos com o Stripe.

Calendário — Google e Microsoft

Através do cartão Calendário, sincroniza eventos nos dois sentidos entre o Univents e a sua aplicação de calendário.

  1. Clique em Ligar calendário para iniciar uma autenticação.
  2. Após a autenticação, surge o cartão de ligação. No menu pendente Selecionar calendário, escolha o calendário de destino pretendido.
  3. Com Atribuir espaços, define quais dos seus espaços devem escrever eventos neste calendário. Sem atribuição, os eventos vão para todos os calendários ligados.
  4. Com Sincronizar agora, obtém manualmente os compromissos externos.
  5. Se o cartão de ligação mostrar o selo Ligação expirada — ligar novamente, clique no botão com o mesmo nome para renovar a autenticação.

Os detalhes encontram-se no artigo Configurar a sincronização de calendário.

Caixa de entrada de e-mail — Gmail, Outlook, IMAP

Através do cartão Caixa de entrada de e-mail, espelha os e-mails recebidos no Univents e associa mensagens a pedidos, eventos e contactos.

Antes de ligar, escolha em Visibilidade das novas contas de e-mail:

  • Por workspace (predefinição) — todos os administradores veem a caixa de entrada.
  • Por utilizador — só a pessoa que ligou a conta a vê. Ainda assim, é possível partilhar e-mails individuais: assim que associa um e-mail a um evento, todos os que podem ver esse evento passam a vê-lo.

Em seguida, clique em Ligar conta de e-mail e siga o fluxo de autenticação. Na primeira sincronização, pode demorar até 24 horas até todas as mensagens históricas serem carregadas. Os detalhes encontram-se no artigo Como integro a minha caixa de e-mail?.

Entrada de e-mail — pedidos por e-mail

Através do cartão Entrada de e-mail, obtém um endereço Univents próprio. Se reencaminhar pedidos de clientes para esse endereço — ou o indicar logo no seu site —, cada e-mail chega automaticamente como pedido à caixa de entrada de pedidos, em vez de se perder numa caixa de correio.

Ligações do Claude

Através do cartão Ligações do Claude, liga o seu workspace ao Claude. Depois, pode perguntar diretamente por eventos, contactos ou documentos e pedir que tarefas sejam executadas, sem iniciar sessão no Univents. Na página de detalhe vê todas as ligações existentes e pode revogar cada uma individualmente.

Chave de API

Através do cartão Chave de API, cria e gere chaves para integrações externas e automatizações próprias.

  1. Clique em Criar nova chave.
  2. Dê à chave um Nome descritivo (p. ex. «Claude Desktop», «Workflow n8n» ou «Exportação DWH»).
  3. Em Permissões, selecione os âmbitos necessários — separados por recurso em Marcar como lida e Escrita (p. ex. events:read, contacts:write). Para simples exportações de dados para DWH/BI bastam os âmbitos de Marcar como lida; mcp:read é o acesso de IA/MCP. Escrita não implica leitura — ambas são selecionáveis individualmente.
  4. Clique em Criar. A chave completa é mostrada apenas uma vez; copie-a de imediato através do ícone de copiar.
  5. As chaves que já não são necessárias podem ser desativadas com Revogar ou removidas definitivamente com o ícone de eliminar.

Todas as permissões em detalhe encontram-se no artigo Gerir chaves de API e ligações MCP.

Contabilidade — DATEV, BMD, sevdesk e bexio

Para a contabilidade, existem dois caminhos: a exportação por ficheiro (descarrega um ficheiro CSV e entrega-o — o caminho para DATEV e BMD) e a transferência direta (liga a sua conta uma vez e, a partir daí, cada fatura emitida é transferida com um clique — o caminho para sevdesk, bexio e Lexware Office).

Através do cartão DATEV, exporta as suas faturas emitidas como lote de lançamentos DATEV (EXTF-CSV) — o formato que os contabilistas na Alemanha e na Áustria esperam para importar para o seu software de gabinete.

  1. Abra o cartão DATEV e introduza em Definições DATEV os dados do seu contabilista: Número de consultor, Número de mandante, Plano de contas (SKR03 ou SKR04), bem como as contas predefinidas de devedores e de receitas. Clique em Guardar definições.
  2. Se estes dados ainda estiverem em falta, o Univents mostra no topo da página o aviso Faltam as definições DATEV — siga a ligação para os preencher.
  3. Com as definições guardadas, escolha na secção Exportar lote de lançamentos o período pretendido (De/Até) e clique em Descarregar CSV DATEV.
  4. As faturas já exportadas do período escolhido são ignoradas automaticamente na exportação seguinte. Para exportar de novo — por exemplo, após uma correção —, ative a opção Reexportar: incluir faturas já exportadas.

Para empresas austríacas, o cartão BMD oferece o mesmo caminho no formato BMD — os detalhes encontram-se no artigo Exportação BMD.

Através dos cartões sevdesk e bexio, liga a sua conta uma vez (no sevdesk por token de API, no bexio por autenticação) e transfere depois cada fatura emitida, bem como os seus contactos de clientes, com um clique. Os guias passo a passo encontram-se em Como ligo a minha conta sevdesk? e Ligar e utilizar o bexio.

Todos os campos de definição em detalhe encontram-se no artigo Exportações e integrações de contabilidade.

API REST (exportação de dados para DWH/BI)

O Univents disponibiliza uma API REST regular (v1) — concebida para a importação contínua dos dados do seu workspace para um data warehouse ou ferramenta de BI (extração completa inicial + sincronização delta incremental). Não é necessário MCP/IA; esta é a via clássica e estruturada.

  • Especificação (pública, acessível sem chave, importável diretamente no Postman/codegen):
  • Autenticação: chave de API Bearer com âmbitos de Marcar como lida por recurso (ver acima).
  • Fluxos de dados: eventos, contactos e empresas, espaços (dados mestre), bem como pedidos, reservas + linhas e documentos financeiros — orçamentos/faturas/guias de remessa — incluindo linhas (dados transacionais).
  • Sincronização delta: com updated_since, obtém apenas as alterações; a paginação por cursor devolve páginas completas (se necessário, desduplicar por id). Os registos eliminados aparecem como tombstones (include_deleted=true) ou no fluxo próprio /deleted-records. Todos os carimbos de data/hora são ISO 8601 UTC. Limite: 120 pedidos/minuto por chave.

Para uma configuração em contínuo, contacte o suporte — disponibilizamos uma chave e acrescentamos de forma dirigida os campos em falta.

Mensagens — SMS e WhatsApp

Na categoria Mensagens, encontra os cartões SMS e WhatsApp (ambos Beta). Com eles, notificações selecionadas – turno atribuído, cancelado, lembrete, lembrete antes do evento – seguem também por SMS ou WhatsApp para o pessoal e para os clientes, com o seu próprio identificador de remetente ou o seu próprio número WhatsApp Business. Para isso, precisa do módulo adicional Mensagens a partir do Core; cada SMS custa adicionalmente 0,15 €, cada mensagem de WhatsApp 0,10 € (serviço) ou 0,22 € (publicidade), debitados do saldo. Tudo o resto em Notificações por SMS e Ligar e utilizar o WhatsApp.

Telefonia — easybell

Na categoria Telefonia encontra o cartão Central telefónica easybell (beta). Com ele, o Univents reconhece quem está a ligar, mostra-lhe o cliente correspondente com orçamentos e eventos e regista cada conversa no contacto, sem gravação. A partir de qualquer contacto liga com um clique. O requisito é a central telefónica na nuvem easybell Classic ou Pro; a ligação está incluída a partir do plano Growth. Tudo o resto em Ligar a central telefónica (easybell).

Perguntas frequentes

Não encontro uma integração — onde devo procurar? Se a barra de categorias à esquerda estiver numa categoria específica, só vê os cartões dessa categoria. Clique em Todos ou utilize o campo de pesquisa no topo e voltam a aparecer todas as integrações.

Como volto de uma página de detalhe? Através da ligação ← Todas as integrações, no canto superior esquerdo de cada página de detalhe.

Já posso ligar sevdesk, bexio, BMD, DATEV, Lexware Office ou BuchhaltungsButler? DATEV, BMD, sevdesk, bexio e Lexware Office já pode utilizar. Só o BuchhaltungsButler ainda está Brevemente disponível e, de momento, não pode ser ligado — nem através do suporte. Manifeste o seu interesse no cartão e informamos quando estiver disponível.

O BMD é uma ligação real? Não. O BMD é uma exportação CSV — ou seja, um ficheiro que entrega à sua contabilidade, não uma ligação contínua entre os sistemas. Já sevdesk e bexio são ligações reais: liga uma vez e depois transfere cada fatura com um clique.

Posso ligar vários calendários em simultâneo? Sim: um calendário comum para todo o workspace e, adicionalmente, cada acesso com direitos de gestão pode ligar o seu próprio calendário pessoal.

O que acontece quando a ligação ao calendário ou ao e-mail expira? O Univents mostra o selo Ligação expirada — ligar novamente diretamente no cartão de ligação. Clique nele para renovar a autenticação; todas as definições anteriores (seleção de calendário, atribuição de espaços) mantêm-se.

A minha chave de API é segura? Guarde a chave como uma palavra-passe. Depois de criada, o Univents mostra-a exatamente uma vez. Se uma chave cair em mãos erradas, revogue-a de imediato com Revogar e crie uma nova.

Posso exportar os meus dados por API para um DWH próprio? Sim. Utilize a API REST (ver secção acima) com uma chave de Marcar como lida. Está concebida para exportação contínua, completa e delta; a especificação está disponível publicamente em https://univents.app/api/v1/openapi.json e pode ser importada diretamente para as suas ferramentas.

O que exporta exatamente a exportação DATEV? Faturas emitidas finalizadas (já não em rascunho) do período escolhido, como lote de lançamentos no formato EXTF-CSV — prontas para importar no software de gabinete do seu contabilista. Os detalhes de cada campo encontram-se no artigo Exportações e integrações de contabilidade.

No cartão DATEV aparece «Desde Growth» — porquê? A exportação DATEV está desbloqueada a partir do plano Growth. O selo de plano indica-lhe isso logo no cartão, em vez de só depois do clique. Se abrir o cartão mesmo assim, o Univents mostra uma informação de upgrade em vez da funcionalidade de exportação.

Posso mostrar a visão geral a alguém que não tenha acesso ao Univents? Sim. Em https://univents.app/integrationen está disponível publicamente a mesma visão geral — útil para mostrar ao seu contabilista ou a colegas o que o Univents consegue ligar.

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