Primeiros passos
Configure seu espaço, conecte o formulário e verifique o recebimento e as notificações.
Do primeiro acesso ao primeiro envio verificado
Comece no painel Apointoo. Este guia cobre o uso do painel hospedado. Para integrar o SDK em um servidor próprio, consulte Desenvolvedores.
1. Abra o espaço certo
Entre na sua conta e selecione o espaço da empresa. Se ainda não tiver um espaço, siga a criação de conta e espaço disponível na tela de acesso. No cadastro por email, abra o link de confirmação e entre novamente para continuar. Salve a chave de integração quando ela for exibida: ela aparece uma única vez. Confira o nome da empresa antes de alterar configurações: cada espaço tem sua própria integração.
Em Configurações, confira os dados da empresa, o fuso horário e a moeda. Escolha o fluxo que você precisa: contatos, pedidos de orçamento ou agendamentos. Configure serviços e disponibilidade quando o fluxo exigir. Salve as alterações.
2. Decida quem recebe as notificações
Se quiser emails, configure o provedor disponível, o remetente verificado e o email de notificação do operador. Esse destinatário pode ser diferente do email usado para entrar no painel. Salve e confira o valor salvo.
Se as notificações estiverem desativadas, os registros podem chegar ao painel sem enviar emails. Uma chave de provedor configurada não comprova entrega. Em integrações de agenda externas, siga também as instruções específicas de webhook e disponibilidade.
3. Conecte o formulário do site
Use as instruções de configuração do seu espaço para obter o endereço de integração, o slug e a chave. Confira a origem permitida do site, incluindo www quando usado. Entregue as instruções ao responsável pelo site.
- Um formulário que envia para uma rota do próprio site, como
/api/contact, usa uma integração de servidor. ConfigureAPOINTOO_TENANT_KEYno servidor, se esse for o nome lido pelo código. - Uma integração que chama Apointoo diretamente do navegador usa outra configuração. Siga o contrato específico dessa integração; não troque os nomes das variáveis por tentativa.
- O snippet de atribuição captura dados de campanha. Ele não envia o formulário por você.
No projeto de hospedagem correto, configure as variáveis no ambiente que será publicado. Edite uma variável existente quando houver duplicata. Após salvar, faça um novo deploy do site. Alterar uma variável não atualiza uma publicação anterior. Veja Deploy.
4. Faça um envio real
Abra o site publicado e envie o formulário com uma mensagem única, como Teste de integração + data e hora, usando um endereço de email que você controla. Marque claramente como teste. Para reservas, use um procedimento de teste que evite bloquear disponibilidade comercial.
No mesmo espaço do painel, encontre o registro e confira a mensagem, o horário e o identificador do envio, quando disponível. Se o contato já existe, confira o conteúdo e o horário do novo envio; não use apenas o total de leads como prova. A mensagem de sucesso do site, sozinha, não comprova recebimento no painel.
5. Verifique o email desse envio
Se as notificações estiverem ativas, confira os eventos de email associados ao teste e peça ao destinatário para verificar a caixa de entrada e spam.
| Evidência | O que comprova |
|---|---|
| Configuração salva | Valores foram salvos; a integração ainda precisa de teste |
| Registro correspondente no painel | Apointoo recebeu esse envio |
| Enviado | Há um evento de envio; não comprova entrega |
| Entregue | O provedor informou entrega; não garante posição na caixa de entrada |
| Destinatário confirma recebimento | O email chegou à caixa consultada |
| Sem eventos | Entrega ainda não verificada; confira modo de notificações, destinatário e provedor |
Use os eventos do teste atual. Um email antigo não comprova o novo envio. Se o painel recebeu o formulário mas o email não chegou, investigue notificações separadamente antes de mudar a chave do site.
6. Conclua e avance
O fluxo de contatos está verificado quando o envio real aparece no espaço correto e o destinatário confirma o email, caso notificações façam parte do fluxo. Com emails desativados por escolha, documente essa decisão.
Google Ads é opcional para receber contatos. Depois, conecte a conta e configure as ações de conversão para os resultados que realmente acontecem. Um lead recebido não é uma venda nem prova de upload de conversão. Consulte Atribuição e API de conversões.
Leitura complementar