Como criar sua própria integração com a Atendalia
Uma integração própria recebe eventos da Atendalia por webhooks de saída ou usa uma chave de API para gerenciar agendamentos. Defina a direção dos dados, os eventos e a verificação antes de programar.
O que você pode fazer com seu sistema
Leve agendamentos e avisos ao sistema que seu negócio já utiliza. Um webhook é um aviso automático; uma API permite pedir informações ou uma ação. Você pode evitar o Zapier quando seu sistema recebe os dados diretamente. Sua equipe técnica prepara essa conexão. Para uma agenda, comece com a agenda da Atendalia ou a conexão direta com Google Calendar.
Escolha a direção dos dados
Use um webhook de saída quando seu sistema precisar receber avisos sobre agendamentos. A Atendalia envia o evento ao seu endpoint HTTPS. Use a API pública quando sua aplicação precisar consultar disponibilidade ou gerenciar reservas.
As conexões não são automaticamente bidirecionais. Defina qual sistema é a fonte de cada registro para evitar duplicações.
Prepare um endpoint seguro
O webhook próprio precisa de uma URL HTTPS pública. O painel rejeita endereços privados ou locais. Guarde o segredo de assinatura no servidor e valide as solicitações antes de processar dados de clientes.
Responda de forma previsível e registre erros sem dados pessoais desnecessários. Comece com informações fictícias.
- Use HTTPS em domínio sob seu controle.
- Selecione apenas os eventos necessários.
- Proteja e troque segredos expostos.
- Trate eventos repetidos com segurança.
Configure e teste no painel
Abra Integrações, escolha Meu próprio sistema, informe a URL e o segredo e selecione os eventos. Faça um teste e verifique tanto o histórico da integração quanto os registros do servidor.
Para fluxos sem endpoint próprio, considere Zapier ou Make e confira limites e custos separados.
Use a API nos fluxos adequados
A chave de API aparece apenas uma vez. Mantenha-a no servidor, nunca em JavaScript público ou aplicativo sem proteção. Revogue as chaves que não utiliza.
A API pública oferece rotas de agendamentos e disponibilidade. Confira campos, respostas e erros antes de automatizar a sincronização e teste criação e cancelamento com dados de exemplo.
Confira o percurso completo
Crie um agendamento de teste, confirme o evento, inspecione os campos recebidos e verifique que nenhuma segunda reserva foi criada. Repita com cancelamento e falha do endpoint.
O guia Meu próprio sistema contém um exemplo de payload e os eventos disponíveis. Use-o como referência antes de atender clientes reais.