Calendly
Ligue o Calendly para receber dados de atribuição das perguntas do formulário de agendamento. Quando alguém marca uma reunião, o Calendly envia um webhook com todas as respostas do convidado — incluindo a sua pergunta “Como soube de nós?” — que o Finseo normaliza em canais de atribuição.Requisitos
- Os webhooks do Calendly exigem um plano pago: Standard, Teams ou Enterprise (não disponíveis no Free).
- As subscrições de webhook são criadas através da API do Calendly — não há um interruptor na interface. Precisa de um personal access token da sua página de integrações do Calendly.
- Uma pergunta ao convidado no seu tipo de evento, p. ex. “Como soube de nós?”.
Obter o seu URL de webhook
- No Finseo, abra Integrations → Calendly → Connect.
- Copie o seu URL de webhook pessoal (contém o ID do seu projeto,
?source=calendlye um token secreto):
Criar a subscrição de webhook
Crie a subscrição com uma única chamada à API (substitua o token e os URLs):"scope": "user" com um URI de user se só quiser as suas próprias marcações. O Finseo extrai automaticamente a resposta de atribuição do array questions_and_answers.
Consulte a documentação de webhooks do Calendly para mais detalhes.
Testar e mapear campos
- Use o live listener na janela de ligação do Finseo: marque uma reunião de teste e inspecione o payload recebido.
- Se a sua pergunta estiver formulada de outra forma, selecione a resposta certa em Field Mapping.
Resolução de problemas
A API devolve um erro de permissões
A API devolve um erro de permissões
Os webhooks exigem um plano Standard ou superior na conta Calendly proprietária do token. As contas Free podem ler a API mas não podem criar subscrições de webhook.
As marcações chegam sem resposta de atribuição
As marcações chegam sem resposta de atribuição
Certifique-se de que a pergunta faz parte das perguntas ao convidado do tipo de evento (ou de um routing form) — as respostas só aparecem no payload se o convidado realmente viu a pergunta.