app2email API Preços

Documentação

Agendamento de horários pelo WhatsApp

Deixe os clientes marcarem, remarcarem e cancelarem horários dentro do WhatsApp. Os agendamentos vão para o Google Calendar, o Microsoft 365, o Apple iCloud ou o calendário próprio do app2email, com confirmações e lembretes. Inclui o app de calendário, uma página de agendamento online, pagamentos e uma equipe de calendário.

Um cliente escreve "agendar" para o seu número de WhatsApp e escolhe um serviço, um dia e um horário sem sair da conversa.

O agendamento vai para o seu calendário, o cliente recebe uma confirmação e um lembrete é enviado antes da visita.

O que o cliente vê

  1. Ele envia uma palavra de agendamento (agendar, horário, reservar - você escolhe as palavras) ou toca em "Agendar agora" em uma mensagem sua.
  2. Um formulário se abre dentro do WhatsApp (um WhatsApp Flow): escolher um serviço, escolher um dia em um calendário, escolher um horário livre, informar o nome e confirmar.
  3. Ele recebe uma mensagem de confirmação com os detalhes, uma referência e, se você quiser, um arquivo de calendário para adicionar o agendamento ao celular.
  4. Antes do horário, ele recebe um lembrete com os botões Confirmar, Remarcar e Cancelar. Responder CANCELAR ou REMARCAR a qualquer momento também funciona.

Nada para instalar para o cliente e nenhum link para outro site: o formulário é do próprio WhatsApp e se abre na conversa.

A configuração de cinco minutos

  1. Serviços: o que pode ser agendado e quanto tempo leva (uma consulta de 30 minutos, um corte de cabelo de 45 minutos).
  2. Disponibilidade: o seu horário de funcionamento por dia da semana, a grade de horários (a cada 15, 30 ou 60 minutos), intervalos entre agendamentos, quanta antecedência você precisa e com quanta antecedência máxima os clientes podem agendar. Dias especiais (fechado, ou outro horário) ficam no mesmo lugar.
  3. Calendário: conecte o Google Calendar, o Microsoft 365 / Outlook.com ou o Apple iCloud, ou mantenha os agendamentos no calendário próprio do app2email. Os horários ocupados no calendário conectado nunca são oferecidos.
  4. Mensagens: a confirmação, os lembretes e o texto de cancelamento, com as suas palavras, com placeholders para o serviço, a data e o horário.
  5. Publicar: o formulário de agendamento é enviado ao WhatsApp e publicado na Visão geral. Envie um teste para você mesmo e depois ative o Book-and-Pay.

Equipe: adicione as pessoas com quem os clientes podem agendar, cada uma com o próprio horário e, se quiser, o próprio calendário. O formulário passa então a perguntar "Com quem você gostaria?", com "Qualquer pessoa disponível" em primeiro lugar.

Tudo nesta página é configurado na página Book-and-Pay do painel (/dashboard/app/book, que também abre pelas Integrações).

Palavras de gatilho

Uma palavra de gatilho é uma palavra ou uma frase curta que inicia algo quando um cliente a envia. Você escolhe as palavras na aba Trigger.

  • Palavras de agendamento (para começar: book, booking, appointment, reserve, reservation, schedule) enviam o formulário de agendamento.
  • Palavras de cancelamento (cancel) perguntam, com botões, a um cliente que tem um agendamento futuro "Cancelar?".
  • Palavras de remarcação (reschedule, change booking) iniciam um novo agendamento que substitui o futuro.
  • Com vários formulários, cada formulário pode ter as suas próprias palavras na aba Flows. Elas têm prioridade sobre as palavras de agendamento.

As palavras são reconhecidas como palavras inteiras. Maiúsculas e acentos não importam: "Agendar", "AGENDAR" e "agendar!" são iguais, e "agendador" não conta.

Mensagens longas são ignoradas

Uma palavra de gatilho só vale em uma mensagem curta: uma com menos de 10 outras palavras. Uma mensagem mais longa que por acaso contenha "booking" ou "cancel" não inicia nada e é tratada como qualquer outra mensagem.

Você pode alterar esse número na aba Trigger ("Ignore the words in long messages"), de "só quando a palavra é a mensagem inteira" para "em uma mensagem de qualquer tamanho".

Calendários

Com o Google Calendar e o Microsoft 365, você entra uma vez e escolhe o calendário em que os agendamentos são gravados e quais calendários devem bloquear horários.

O Apple iCloud e outros servidores CalDAV se conectam com uma senha específica de app.

Um link de calendário somente leitura (.ics) pode bloquear horários enquanto os próprios agendamentos continuam no calendário do app2email.

Se um calendário conectado deixar de responder, os agendamentos continuam funcionando e o painel avisa para você reconectar.

A regra das 24 horas e os lembretes

O WhatsApp permite que uma empresa envie texto livre por 24 horas depois da última mensagem do cliente. As confirmações chegam dentro dessa janela, então são o seu próprio texto.

Os lembretes geralmente saem depois disso. Por isso, o app2email cria um pequeno conjunto de modelos utility aprovados no seu número no momento em que você ativa os agendamentos (a Meta os analisa, normalmente em até uma hora) e usa o modelo correspondente sempre que a janela está fechada.

Os incentivos para reagendar ("faz tempo que você não vem") são mensagens de marketing e só vão a contatos que concordaram com marketing.

Acompanhamentos e relatórios

Depois de uma visita, pode seguir uma nota de pós-atendimento com os links dos seus produtos e uma avaliação com um toque.

A aba Reports mostra os agendamentos por origem, as faltas, as avaliações e quais serviços e membros da equipe são os mais ocupados.

O app de calendário

Os seus agendamentos têm um app próprio em /calendar (www.app2email.com/calendar). Ele foi feito para telas sensíveis ao toque: um tablet na recepção ou um celular no bolso. Os botões são grandes e as folhas deslizam de baixo para cima em uma tela estreita.

  1. Abra-o pela entrada "Calendar" no menu do painel, ou vá a /calendar e faça login. Se você tem várias empresas, alterne entre elas na barra superior.
  2. Escolha uma visualização: Dia, Semana, Mês ou Lista. Deslize para a esquerda ou para a direita para ir ao dia seguinte ou anterior (semana, mês). Toque na data para saltar com um seletor de mês. Com equipe, toque em uma etiqueta de membro para ver só uma pessoa.
  3. Agende: toque em "+ New", ou toque em um horário vazio na visualização do dia. Escolha o cliente (pesquise ou digite um número com código do país), o serviço, o membro da equipe ("Qualquer pessoa disponível" é uma opção) e um dos horários livres. Ative "tell the customer" para enviar a confirmação.
  4. Mova: abra o agendamento, toque em Move e escolha um novo horário. O agendamento mantém a sua referência. O cliente é avisado se você deixar "tell the customer" ativado.
  5. Cancelar, concluído, falta: abra o agendamento e toque no botão. Um cancelamento pede um motivo.
  6. Bloquear horário: toque em "+ New" e depois em "Block time". Escolha um membro da equipe ou todos, as horas ou dias inteiros e um título (almoço, feriado). O horário bloqueado nunca é oferecido aos clientes.
  7. Notas: notas internas sobre um cliente ou sobre um agendamento. Fixe as importantes. O cliente nunca as vê. Uma nota pode ter uma data "Remind me on"; você recebe um e-mail nesse dia.

Clientes e enquetes

Customers lista todos os que agendaram, com visitas, faltas, agendamentos futuros e passados, notas, pacotes e pagamentos. Dali você pode editar tags e dados, enviar uma mensagem de WhatsApp ou um e-mail e pedir ao assistente um rascunho ou um breve resumo de preparação.

Polls permite oferecer de dois a dez horários e deixar as pessoas votarem (veja Tipos de evento).

O calendário mostra em cinza os horários ocupados de um calendário conectado do Google, da Microsoft ou da Apple, para que nada fique escondido de você. A tela é atualizada a cada 30 segundos.

Equipe do calendário

Você pode convidar pessoas somente para o calendário. Elas não veem o seu painel, as suas mensagens nem as suas configurações.

  1. Abra o calendário, depois o menu e depois Team (só administradores).
  2. Digite o endereço de e-mail da pessoa, escolha uma função e, opcionalmente, qual membro da equipe ela é.
  3. Envie o convite. A pessoa recebe um e-mail com um link, entra ou cria um login e chega ao seu calendário.
  4. Você pode alterar uma função, reenviar um convite ou remover uma pessoa a qualquer momento.

Funções

FunçãoO que a pessoa pode fazer
AdministradorTudo no calendário: agendar, mover, cancelar, bloquear o horário de qualquer pessoa, todas as notas, a equipe, o compartilhamento, pagamentos e reembolsos, excluir dados de clientes.
EquipeVer o calendário, agendar, mover e cancelar, bloquear o próprio horário, escrever notas e enviar mensagens a clientes. Só o próprio feed de compartilhamento.
VisualizadorApenas olhar. Sem botões que alterem algo.

Duas opções para cada pessoa

Elas servem principalmente para a equipe:

  • Somente os próprios registros: a pessoa vê e altera apenas os agendamentos do seu próprio membro da equipe (você precisa escolher o membro da equipe).
  • Ocultar os dados de contato do cliente: números de telefone e endereços de e-mail aparecem como "•••• 4567". Isso também vale para o que é enviado ao assistente.

As pessoas que já têm uma função no seu painel recebem automaticamente a função de calendário correspondente: proprietário e administrador são administradores, membro é equipe, visualizador é visualizador.

Página de agendamento online

Além do formulário do WhatsApp, os clientes podem agendar em uma página web para celular. Ela não exige login nem app. Configure-a na página Book-and-Pay do painel, aba Online booking.

  1. Ative a página.
  2. Escolha o endereço: www.app2email.com/book/ seguido de um nome curto seu (de 5 a 40 letras, dígitos ou hifens). Pressione "Check and save". Se o nome já estiver em uso, você é avisado.
  3. Escreva um título e uma breve introdução se quiser alterar os padrões.
  4. Copie o link, imprima o QR code ou copie o trecho de incorporação para o seu próprio site (um iframe; adicione ?embed=1 para ocultar o cabeçalho e defina as cores com color, bg e text).

Digite {booking_link} em qualquer texto para o cliente e o app2email o substitui por um link feito para esse cliente. Ele o abre já identificado: sem número para digitar, e o agendamento fica ligado à conversa dele.

Você pode usá-la na resposta do gatilho, na confirmação, nos lembretes, nas mensagens de cancelamento e de remarcação, no acompanhamento e no texto de "sem horários livres".

O link expira depois do número de dias que você definir (7 por padrão). Textos enviados como modelos fora da janela de 24 horas não podem incluí-lo. Se a página estiver desativada, a tag fica vazia.

O que uma palavra de gatilho envia

Você escolhe uma de três opções: o formulário do WhatsApp (como antes), um botão que abre a página online, ou o formulário com o link da página sob o texto dele. Se ainda não houver um formulário publicado, o link é enviado.

Um cliente que o app2email ainda não conhece

  1. O cliente abre o seu endereço público e escolhe um serviço, um horário e informa um nome.
  2. O horário é reservado por alguns minutos (10 por padrão; você pode definir de 5 a 30).
  3. A página mostra um botão que abre o WhatsApp com uma mensagem pronta, "Confirm booking BK-...". O cliente a envia.
  4. O agendamento é feito, a página mostra "You're booked" e a confirmação chega no WhatsApp, com um botão "Pay now" quando o serviço é pago online. Se o tempo acabar, o horário é liberado e o cliente pode escolher de novo.

Isso comprova que o cliente é o dono do número de WhatsApp. Um cliente que chega por um link pessoal não precisa dessa etapa.

Gerenciamento e limites

Com um link pessoal, o cliente pode ver os seus agendamentos futuros e cancelá-los ou movê-los (você pode desativar isso).

Você pode definir um prazo máximo antes do início para os clientes fazerem alterações e um limite de agendamentos por dia. Você, a API e o app de calendário nunca são limitados por eles.

Feed de calendário (.ics)

No calendário, abra Sharing e crie um link de feed para você ou para um membro da equipe. Adicione-o ao Google Calendar, ao Apple Calendar ou ao Outlook como uma assinatura e os seus agendamentos e horários bloqueados aparecem lá.

O feed tem nomes, serviços e referências, nunca os números de telefone dos clientes. Revogue um link de feed a qualquer momento.

Tipos de evento

  • Individual: um cliente por horário. É o padrão.
  • Grupo: defina "places" em um serviço (de 1 a 200). O mesmo horário de início continua disponível até que todas as vagas sejam ocupadas. Cada cliente tem o próprio agendamento, as próprias mensagens e o próprio pagamento. A página mostra quantas vagas restam.
  • Todos participam: escolha de dois a dez membros da equipe. Um horário só é oferecido quando todos estão livres, e o evento vai para o calendário de cada pessoa.
  • Rodízio: nas configurações da equipe, escolha como "Qualquer pessoa disponível" escolhe uma pessoa: a primeira livre, ou a livre com menos agendamentos por volta desse horário.
  • Enquetes: no calendário, abra Polls e toque em dois a dez horários livres. Envie o link. As pessoas votam na página, sem login. Quando você escolhe um horário, um agendamento é feito para o cliente que você indicou, ou o horário é bloqueado. Os horários não ficam reservados enquanto a votação está aberta.

Receber pagamentos

Você conecta a sua própria conta Stripe ou PayPal. O dinheiro vai direto do cliente para a sua conta.

O app2email não cobra taxa e nunca retém o seu dinheiro. Valem as taxas e os recibos do próprio provedor de pagamento. Uma moeda por número.

Conecte e defina os preços

  1. Abra Bookings, Payments. A página indica onde encontrar cada chave.
  2. Stripe: cole uma chave secreta ou restrita. O app2email a verifica e adiciona o próprio webhook à sua conta. PayPal: informe o client id e o secret de um app REST e escolha live ou sandbox. Só o proprietário ou um administrador pode conectar ou desconectar.
  3. Escolha a moeda e quais métodos os clientes podem usar (um ou ambos).
  4. Em cada serviço, defina o preço e se o pagamento é required (obrigatório), optional (opcional) ou none (nenhum). Adicione um sinal para cobrar só uma parte agora; o restante é pago na visita.

Como funciona

  • Obrigatório, na página online: por um link pessoal, o horário fica reservado enquanto o cliente paga, e o agendamento é feito quando o pagamento é confirmado (um pagamento que expira ou é cancelado libera o horário). No seu endereço público, o cliente primeiro confirma o horário no WhatsApp, como acima, para que você saiba de quem é o agendamento. O agendamento é então feito com o botão "Pay now" na confirmação do WhatsApp e é cancelado se não for pago em 1 dia e, no máximo, 2 horas antes do horário (um agendamento feito mais tarde que isso ainda recebe 30 minutos).
  • Formulário do WhatsApp e agendamentos que você faz: o agendamento é feito e a confirmação traz um link "Pay now". Com "optional", nada é cancelado. Com "required", você pode cancelar automaticamente os agendamentos não pagos depois de um número de minutos que você escolhe (0 significa nunca).
  • Cupons: um código, uma porcentagem ou um valor, para alguns ou todos os serviços, com um número máximo de usos e uma data final.
  • Pacotes pré-pagos: por exemplo, 10 sessões por um preço, válidas por alguns dias. Os clientes compram um na página online, ou você concede um no balcão. Agendar com um pacote não cobra nada e usa uma sessão. Um cancelamento devolve a sessão quando você cancela ou quando o cliente cancela a tempo.
  • Links de pagamento avulsos: no calendário, solicite um pagamento a um cliente com um valor e uma descrição, enviado pelo WhatsApp ou copiado para você enviar.
  • Reembolsos: escolha em Payments se um cancelamento nunca reembolsa, pergunta a você ou reembolsa integralmente de forma automática. Você também pode reembolsar pelo calendário, integral ou parcialmente.

Um pagamento só conta como pago quando o Stripe ou o PayPal o confirma. O app2email guarda o valor, o status e a referência do provedor, nunca dados de cartão.

Notificações

  • E-mails para o cliente: quando o agendamento tem o endereço de e-mail do cliente, a confirmação (com um arquivo de calendário), o cancelamento, o aviso de remarcação, os lembretes e o acompanhamento também vão por e-mail, além do WhatsApp. As respostas vão para o endereço que você escolher. Ative isso em Bookings, Notifications.
  • Regras extras: até 20 regras como "enviar uma nota sobre estacionamento no dia anterior". Cada regra tem um gatilho (agendado, cancelado, movido, antes do início, depois do fim, concluído, falta, pago), um atraso, os serviços a que se aplica, quem a recebe (o cliente, você ou o membro da equipe) e o canal (WhatsApp ou e-mail).
  • Fora da janela de 24 horas: uma regra no WhatsApp é enviada como texto livre só dentro da janela. Fora dela, a mensagem vai por e-mail se o cliente tiver um endereço. Se não tiver, ela é ignorada e o log informa isso. Os lembretes embutidos continuam usando modelos aprovados, como descrito acima.

Identidade visual

Na aba Online booking, você pode enviar um logotipo (PNG, JPEG ou WEBP, até 300 KB), escolher uma cor de botão e uma cor de fundo e ocultar a linha "Powered by app2email".

Você também pode escrever uma política de cancelamento que aparece na etapa de revisão e junto ao agendamento, adicionar até três botões na página "You're booked" e encaminhar os clientes a uma página sua alguns segundos depois do agendamento.

Exclusão de dados de clientes

Um administrador pode apagar os dados de agendamento de um cliente: no calendário, abra o cliente e escolha "Delete customer data" (você digita uma confirmação). A API tem a mesma chamada.

  • Os agendamentos futuros são cancelados sem uma mensagem ao cliente.
  • Em todos os agendamentos, o nome, o e-mail, as notas e o feedback são apagados e o número do cliente é substituído por um código aleatório.
  • As notas, os links, as reservas e os votos em enquetes desse cliente são excluídos. Os pagamentos e os pacotes mantêm o valor e a data, mas perdem o nome e o número.
  • Os relatórios continuam contando os agendamentos anonimizados.

Isso não exclui o contato nem a conversa do WhatsApp; esses ficam com a página Contacts.

Para a exclusão automática, defina "keep customer details for N days" (de 30 a 3650) nas configurações de privacidade. Uma vez por dia, os dados dos agendamentos que terminaram há mais tempo que isso são apagados da mesma forma. 0 mantém tudo.

Para desenvolvedores e agentes

Tudo o que o painel faz está na API REST em /v1/{number}/bookings: listar e criar agendamentos, cancelá-los, ler os horários livres e as configurações de agendamento.

O seu sistema pode receber os eventos de webhook booking.created, booking.cancelled e booking.rescheduled. As mesmas ferramentas existem no servidor MCP para agentes de IA.

A referência da API traz os parâmetros e exemplos. Por finalidade:

  • Calendário: ler o calendário unificado de agendamentos e bloqueios; criar, alterar e excluir horários bloqueados.
  • Encontrar horários: serviços, equipe, os próximos horários livres, reservas de um horário.
  • Alterar agendamentos: atualizar detalhes, mover um agendamento no mesmo lugar.
  • Notas: ler e escrever notas em um agendamento ou em um cliente, com lembretes.
  • Links: links de agendamento pessoais, listar, revogar.
  • Clientes: perfis, atualizar, apagar dados de agendamento.
  • Pagamentos: listar, links de pagamento, reembolsos, marcar um agendamento como pago; pacotes e concessões.
  • Enquetes: criar, listar, encerrar, agendar um horário.
  • Webhooks: booking.updated, booking.note.created, calendar.block.created, calendar.block.deleted, booking.paid, booking.refunded, payment.paid, package.purchased, poll.voted, poll.closed, booking.customer.erased. Todo webhook recebe todos os eventos.
  • MCP: ferramentas correspondentes para agentes, por exemplo get_calendar, find_next_booking_slots, reschedule_booking, add_booking_note, create_booking_link, request_payment.

As gravações exigem o escopo bookings:manage. Chaves sandbox não podem gravar, reembolsar nem apagar.

Ainda não disponível

  • Agendamentos recorrentes e lista de espera.
  • Agendamentos que precisam primeiro da sua aprovação.
  • Assinaturas e cobranças recorrentes.
  • Impostos e notas fiscais (o recibo do Stripe ou do PayPal é o recibo).
  • Pagamentos parcelados além de um único sinal, e pagamento com cartão dentro do próprio WhatsApp.
  • E-mail em massa para clientes (o Broadcasts envia WhatsApp em massa).
  • Um agendamento sem um número de WhatsApp: todo cliente precisa de um.
  • Arrastar e soltar no calendário (Move é um botão).
  • Idiomas diferentes do inglês na página online.

Tudo o que foi descrito acima é configurado na página Book-and-Pay do painel (/dashboard/app/book). Dúvidas: support@app2email.com.

Voltar ao topo