API e integrações
A integração pronta para usar é o Widget de reservas: o cartão para reservar mesas e pedir eventos, para colar no seu site (código ou plugin do WordPress). É um complemento de 9 €/mês, a partir do plano Ristorante. APIs de verdade, a sincronização com seu caixa/sistema de gestão e o white-label não estão em nenhum plano self-service: são feitos sob demanda, escrevendo para nós.
Em resumo
Muitas «integrações» se resumem a uma pergunta prática: como deixo os clientes reservarem direto do meu site? A Carteia tem a resposta pronta: o Widget de reservas. É o cartão para reservar uma mesa ou pedir um evento, que você cola no seu site em poucos minutos.
As integrações mais técnicas — ligar a Carteia ao seu caixa, a um sistema de gestão, ou usar seu próprio domínio sem a marca (white-label) — não estão incluídas nos planos do catálogo: são construídas sob medida, conversando juntos.
Ristorante O Widget de reservas é um complemento de 9 €/mês, disponível a partir do plano Ristorante.
O Widget de reservas: a integração pronta para usar
Pense nele como um «bloco de reservas» que vive no seu site. O cliente preenche ali, sem pular para outro endereço, e o pedido chega direto ao seu painel da Carteia, ao lado de todos os outros.
O que você pode mostrar
- A reserva de mesa (a mesma que você tem na sua página pública da Carteia).
- O pedido de evento (para quem quer organizar um jantar de grupo ou uma festa).
- Você pode escolher qual dos dois mostrar primeiro, o tema claro ou escuro, e manter ou tirar a pequena assinatura da Carteia embaixo.
Como colocar no site
No painel, abra a seção de integrações e ative o widget: você gera um código de conexão (um token). Mostramos a você uma vez só, então salve na hora.
Indique os domínios do seu site onde o widget pode aparecer (por exemplo
seurestaurante.com.br). Vai funcionar só ali: é uma proteção contra quem tenta copiá-lo em outro lugar.Copie o trecho de código (uma linha de
<script>) e cole na página do seu site onde quer as reservas.Como alternativa, se seu site é em WordPress, instale o plugin «Carteia Booking», cole o token nas configurações e adicione o shortcode onde preferir.
É seguro para o seu site
O widget roda numa janela isolada do resto do seu site (não pode «tocar» as outras partes da página). Aparece só nos domínios que você autorizou, tem um limite de requisições para não ser sobrecarregado e uma proteção anti-spam embutida. Além disso, no painel você vê as estatísticas dos últimos 30 dias: quantas vezes foi carregado e quantos pedidos foram bloqueados.
O que você precisa para ativar
Duas coisas juntas:
- Um plano Ristorante ou superior.
- O complemento Widget de reservas ativo (9 €/mês), que você ativa na seção de assinatura.
Se tiver o plano certo mas não o complemento, você ainda vê a pré-visualização do widget; para publicar de verdade é preciso ativar o complemento.
API, caixa, sistema de gestão, white-label: como funciona de verdade
Aqui esclarecemos uma coisa importante, sem rodeios.
«Fazer a Carteia conversar com outros programas» — é isso que as APIs significam — exige um trabalho dedicado. O mesmo vale para quem gerencia muitos estabelecimentos sob a própria marca (agências, franquias, redes) e quer esconder a Carteia totalmente por trás da sua marca.
Se for o seu caso, escreva para nós contando:
- o que você quer ligar (qual caixa, qual sistema de gestão, qual site);
- quantas unidades estão envolvidas;
- o que deve acontecer quando, por exemplo, você muda um preço no caixa ou chega uma reserva.
A partir daí estudamos juntos a solução certa. Não prometemos botões que não existem: construímos o que você precisa.
Qual escolher
- Quero as reservas no meu site
- É o Widget de reservas. Pronto, self-service, 9 €/mês a partir do plano Ristorante. Você ativa e cola hoje mesmo.
- Quero ligar o caixa ou o sistema de gestão
- É uma integração sob medida. Escreva para nós e a gente conversa: não é um recurso que se liga sozinho.
- Gerencio muitos estabelecimentos e quero minha marca em todo lugar
- É o território do white-label sob medida. Aqui também: contato direto, uma solução construída em torno do seu caso.
Próximos passos
Perguntas frequentes
- Posso colocar as reservas no meu site?
- Sim, é justamente o que o Widget de reservas faz. Você ativa o complemento (9 €/mês, a partir do plano Ristorante), copia um trecho de código ou instala o plugin do WordPress, e o cartão de reserva aparece no seu site.
- A Carteia tem APIs para ligá-la ao meu sistema de gestão ou ao caixa?
- Fazer a Carteia conversar com outros programas (caixa, sistema de gestão, site sob medida) não é um recurso self-service incluído nos planos. É uma integração sob medida: escreva para nós dizendo o que quer ligar e a gente conversa.
- Posso tirar a marca Carteia e usar meu próprio domínio (white-label)?
- O white-label completo não está incluído em nenhum plano do catálogo. É reservado a projetos sob medida (redes, franquias, agências): avaliado caso a caso sob demanda.
- O widget deixa meu site lento ou exposto?
- Não. O widget roda numa janela isolada (sandbox) e só funciona nos domínios que você autoriza. Tem um limite de requisições e uma proteção anti-spam embutida.
Histórico de versões
v2.0.02026-05-29— Reescrita completa e correção de rota: removidas as APIs REST, os webhooks e o white-label descritos como produtos prontos (não existem como recurso self-service; whiteLabelApi=false em todos os planos). Documentado o Widget de reservas como a única integração realmente disponível (complemento booking_embed_widget, 9 €/mês, a partir do plano Ristorante). API/white-label movidos para «contato sob demanda». Removido noindex.v1.1.02026-05-22— Página reformulada como integração enterprise por contato (com noindex).v1.0.02026-05-20— Primeira publicação (descrevia API/webhooks/white-label não implementados).