Introdução
O ecossistema aberto da Altegio permite estender os módulos principais de reservas, CRM e ERP com aplicações de parceiros e integrações personalizadas. Este guia mapeia as categorias do Marketplace, o modelo de instalação multi-filial, os comportamentos de desativação de webhooks e os esquemas de eventos de análise — além de padrões práticos para pagamentos, mensagens/WhatsApp, telefonia IP, CRM e relatórios no Power BI. As referências remetem para a documentação oficial da Altegio para a implementação.
Categorias do Marketplace e documentação representativa
| Categoria | Integrações típicas e o que permitem | Documentação principal |
| Pagamentos | Pré-pagamento/online, venda de subscrições, gestão de taxas de cartão através de gateways (por exemplo, Stripe, VivaWallet, MonoBank, LiqPay, PIX) | Consulte as opções de pagamento nas definições da plataforma e os guias de configuração de parceiros: Definições da plataforma (visão geral de pagamentos), Central de sites parceiros e pagamentos |
| Chatbots, WhatsApp, SMS | Lembretes por WhatsApp/SMS, reativação de clientes, envios em massa, recolha de avaliações | Catálogo de chatbots, Fromni WhatsApp/SMS, SMS.to, Diretório de fornecedores SMS |
| Telefonia IP | Identificação da chamada, gravações de chamadas, fluxos de retorno de chamada, análise de chamadas para toda a rede | Integrações de telefonia IP, Relatórios – Chamadas |
| CRM | Sincronização de leads/reservas com CRMs externos (por exemplo, Kommo através de integradores) | Central de documentação (integrações), Contexto de reservas via redes sociais + CRM |
| Análise e BI | Eventos de reserva no GA4/Meta Pixel, transferência de Client ID, dashboards no Power BI | Ligação ao GA4, Esquema de eventos, Análise do widget + notas, Client ID (UA), Power BI – Smart‑Metrika, Índice Power BI |
| Fidelização e subscrições | Cartões digitais, cartões-oferta, bónus, restrição de reservas online por subscrição | Cartões de fidelização (rede), Transações de fidelização, Integração LoyalCards, Boomerangme, Reservas apenas para subscritores |
Modelo de instalação para redes e franquias
Instalação de aplicações multi-filial
A Altegio permite instalar uma aplicação do Marketplace em várias filiais num único fluxo. Durante a ligação, o utilizador seleciona as filiais; o seu serviço recebe um array de IDs de filial (salon_ids[]). É necessário ativar a sua integração para cada ID de modo a desbloquear o acesso à API e o registo de webhooks por filial. Os programadores ativam isto nas definições da aplicação (“Allow to add the application to several branches”). Consulte o guia de instalação multi-filial.
Unificação de dados da rede (para criadores de aplicações)
- Grafo de clientes: uma base de dados única de clientes de rede e um “cartão de cliente da rede” consolidado expõem o valor gasto, as visitas, os locais visitados e os ativos de fidelização de uma pessoa em toda a rede. Consulte Base de dados de clientes da rede e Cartão de cliente da rede.
- A análise apresenta métricas de clientes únicos, ocupação, reservas e receita para redes; a desduplicação evita contactos repetidos. Consulte Que problemas resolve a análise de rede.
Ciclo de vida do webhook e o fluxo de “desativação”
Quando um utilizador desativa a sua aplicação do Marketplace:
- Todas as definições de integração são eliminadas ao nível da filial.
- O acesso à API é revogado para essa filial e a Altegio deixa de enviar eventos para os seus webhooks.
- A Altegio envia um webhook de “desativação” para o URL de callback configurado nas definições da sua aplicação (formato indicado na documentação da API referida nessa página). Consulte Desativar uma integração.
Esquemas de eventos de análise e atribuição
Ligação e verificação do GA4
Ligue o GA4 adicionando um stream de dados web (G‑XXXXXXXXX) e colando o Measurement ID em Integrações → Análise → Google Analytics. Verifique através dos relatórios em tempo real. Consulte Configuração do GA4.
Taxonomia de eventos do widget de reservas
O widget de reservas online emite eventos padronizados para o GA/Meta, incluindo (lista não exaustiva): widget_loaded, service_selected, master_selected, date_selected, time_selected, booked, appointment_changed, appointment_deleted, company_page_open, master_page_open, review_created. Consulte a Lista completa de eventos e as Notas de análise do widget.
Notas de implementação:
- Cada link de reserva só pode estar associado a um stream de dados (crie formulários adicionais para vários streams). Consulte Configuração do GA4.
- Podem ocorrer pequenas discrepâncias entre os dados de análise e os da plataforma quando os clientes usam múltiplas origens. Consulte as Notas de análise do widget.
- (Legado/UA) É possível transmitir um Client ID personalizado para unificar as identidades do GA e do CRM. Consulte Transferência do Client ID.
Padrões de integração típicos
1) Pagamentos e fluxos de pré-pagamento
- Ative pré-pagamentos online para serviços e eventos de grupo; configure as taxas do fornecedor e onde os fundos são depositados (mapeamento da caixa registadora). Consulte a Central de sites parceiros e pagamentos e o guia de configuração de taxas de cartão.
- Restrinja as reservas online a subscrições ativas quando necessário (fitness/formação). Consulte Reservas apenas para subscritores.
2) Mensagens: automação de WhatsApp/SMS
- Ligue um fornecedor de WhatsApp/SMS para gerir lembretes, reativação de faltas, promoções de aniversário e avaliações; alguns parceiros adicionam gatilhos para clientes “perdidos”. Consulte o Catálogo de chatbots, Fromni WhatsApp/SMS e SMS.to.
- O sistema de notificações principal (SMS/E-mail/Push/WhatsApp) é configurável na Altegio. Consulte a funcionalidade de Notificações.
3) Telefonia IP com análise operacional
- Integre uma centralita virtual/SIP para mostrar o nome do cliente, o cartão de cliente, reserva rápida, transferências e retorno de chamadas; guarde as gravações durante 1 ano e analise as chamadas em Relatórios → Chamadas. Consulte as Integrações de telefonia IP e Relatórios – Chamadas.
4) CRM e origens de leads
- Encaminhe os dados de reservas/leads para o seu CRM (por exemplo, Kommo através de integradores) e utilize pontos de entrada de redes sociais e mapas para converter. Consulte Reservas online com redes sociais e Reservar via Google.
5) Dashboards Power BI para redes
- Envie KPIs empresariais (coortes, retenção, ocupação por horário, vendas por serviço/equipa, plano vs. realizado) para o Power BI via Smart‑Metrika. Consulte Power BI – Smart‑Metrika e o Índice Power BI.
6) Fidelização e cartões digitais
- Emita e sincronize cartões digitais com a Apple Wallet/Google Pay, envie notificações push/baseadas em localização e concilie transações entre localizações. Consulte LoyalCards, Boomerangme e Cartões de fidelização (rede).
Análises e relatórios de rede em que as suas aplicações se podem apoiar
- Rentabilidade dos serviços e repartição de receita (apenas Realizado); filtre por período, categoria de serviço, colaborador e localização; exporte para Excel. Consulte o Relatório de serviços da rede.
- Ganhos da equipa, serviços/produtos vendidos, horas, custo/hora, % da receita, por localização e período; exportações e transferências auditadas. Consulte o Relatório de equipa da rede.
Segurança, privacidade e controlos de acesso
- Papéis de dados: as empresas são responsáveis pelo tratamento dos dados dos seus clientes; a Altegio é a subcontratante. O RGPD é observado. Consulte a Política de Privacidade (UE).
- Infraestrutura e localização dos dados: a hospedagem na UE (Hetzner, Alemanha) está documentada. Consulte Sobre a Altegio.
- Controlos detalhados de direitos de acesso e prevenção de fugas de dados, incluindo mascaramento de contactos de clientes, direitos por secção e registos de atividade. Consulte Proteger os seus dados e Direitos de acesso ao Calendário de Marcações.
Checklist para programadores
- Conceba a solução para multi-filial: trate arrays de IDs de filial e ative a sua aplicação por filial. Consulte a Instalação multi-filial.
- Implemente um gestor de desativação robusto: elimine o estado por filial do seu lado ao receber o webhook de desativação; conte com o facto de a Altegio interromper a entrega de eventos e revogar o acesso à API. Consulte o Fluxo de desativação.
- Emita/consuma eventos de análise usando os nomes de eventos oficiais do widget; ligue corretamente o GA4 e documente eventuais ressalvas de atribuição. Consulte o Esquema de eventos e a Configuração do GA4.
- Para fluxos de mensagens/pagamentos, consulte as páginas de configuração específicas de cada parceiro no Suporte da Altegio para evitar erros de configuração (por exemplo, modelos de WhatsApp, mapeamento de taxas de cartão, regras de subscrição). Consulte as secções acima.
Recursos adicionais
- Central de documentação (multi-módulo, multi-setor): Índice de suporte
- Mapa de documentação de reservas online: Documentação de reservas online
- Catálogo de relatórios de análise: Análise e relatórios