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ção | Categoria | O que faz |
|---|---|---|
| Stripe | Pagamentos | Os clientes pagam diretamente online numa reserva online |
| Calendário | E-mail e calendário | Sincronização bidirecional com Google Calendar ou Microsoft Outlook |
| Caixa de entrada de e-mail | E-mail e calendário | Espelhar uma caixa Gmail, Outlook ou IMAP no Univents |
| Entrada de e-mail | E-mail e calendário | Os e-mails reencaminhados tornam-se automaticamente pedidos |
| Ligações do Claude | IA | Utilizar o Univents como ferramenta no Claude |
| Chave de API | Programadores | Chaves para a API REST e para automatizações próprias |
| DATEV | Contabilidade | Exportar faturas emitidas como lote de lançamentos (exportação por ficheiro) |
| BMD | Contabilidade | Exportar faturas emitidas como lote de lançamentos (exportação por ficheiro) |
| sevdesk | Contabilidade | Transferir faturas e contactos de clientes com um clique |
| bexio | Contabilidade | Transferir faturas e contactos de clientes com um clique |
| Lexware Office | Contabilidade | Transferir 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.
- Clique em Ligar calendário para iniciar uma autenticação.
- 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.
- 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.
- Com Sincronizar agora, obtém manualmente os compromissos externos.
- 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.
- Clique em Criar nova chave.
- Dê à chave um Nome descritivo (p. ex. «Claude Desktop», «Workflow n8n» ou «Exportação DWH»).
- 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. - Clique em Criar. A chave completa é mostrada apenas uma vez; copie-a de imediato através do ícone de copiar.
- 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.
- 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.
- 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.
- 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.
- 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):
- OpenAPI 3.1: https://univents.app/api/v1/openapi.json
- Documentação interativa: https://univents.app/api/v1/docs
- 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 porid). 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.