HubSpot
Ligar o HubSpot em Integrações › Integrações prontas com o token de uma Private App e seis âmbitos. Cria ou atualiza o contacto pelo e-mail, regista a compra e a renovação como negócio ganho sem duplicar, marca o estado da subscrição e recebe os envios de formulário sem sobrescrever contactos.
O HubSpot recebe os membros como contactos e as vendas como negócios ganhos: "Cria ou atualiza o contato no HubSpot e registra compras e renovações como negócios ganhos."
Papel: proprietário e administrador. Como ligar, testar, desligar e remover qualquer app está em Integrações prontas.
1. Crie a Private App no HubSpot
Precisa de ser superadministrador da conta do HubSpot.
- No HubSpot, abra Definições › Integrações › Private Apps e clique em Criar uma private app.
- Dê um nome (Memberfy).
- No separador Âmbitos, marque os seis:
| Âmbito | Para quê |
|---|---|
crm.objects.contacts.read | Encontrar o contacto pelo e-mail |
crm.objects.contacts.write | Criar e atualizar o contacto |
crm.objects.deals.read | Encontrar o negócio de um evento já registado |
crm.objects.deals.write | Criar o negócio e associá-lo ao contacto |
crm.schemas.contacts.write | Criar a propriedade do estado da subscrição no contacto |
crm.schemas.deals.write | Criar a propriedade que evita negócio duplicado |
- Clique em Criar app e copie o token de acesso. Começa por
pat-.
O ecrã da Memberfy também lista os âmbitos em Escopos necessários.
2. Ligue na Memberfy
- Em Definições › Integrações e APIs › Integrações, clique em HubSpot.
- Cole em Token do Private App.
- Escolha os eventos e marque Este app vai receber: ….
- Clique em Ligar e depois em Enviar teste. O teste só verifica o token: não cria contacto.
O que chega
O contacto é identificado pelo e-mail.
| Evento | No HubSpot |
|---|---|
| Um membro entrou na comunidade | Cria o contacto (nome, apelido, e-mail e telefone) ou atualiza o nome e o telefone do que já existe |
| Uma compra foi concluída | Um negócio ganho Compra: {produto}, com o valor pago, no pipeline padrão, associado ao contacto; o contacto fica com o estado da subscrição active |
| Uma subscrição foi renovada | Um negócio ganho Renovação: {produto}, da mesma forma |
| Uma subscrição foi cancelada | O estado da subscrição do contacto passa a canceled |
| Foi enviado um formulário | Cria o contacto com nome, e-mail, telefone, empresa e cargo do formulário e, quando a pessoa aceitou, regista o consentimento. Num contacto que já existe, veja abaixo |
- Sem duplicar: cada negócio guarda o evento que o criou (a propriedade Memberfy event id). Uma nova tentativa ou um Reenviar encontra o negócio já criado e não cria outro.
- As duas propriedades, Memberfy subscription status (no contacto) e Memberfy event id (no negócio), são criadas automaticamente na primeira vez.
- Telefone: vai no formato internacional (
+5541999998888) quando o membro registou um. Nos outros eventos, só entra no contacto criado nesse momento; o que já está no HubSpot não é substituído. - O nome do negócio sai no idioma da comunidade.
- Quando o HubSpot pede para esperar (limite de chamadas), a entrega aguarda e tenta de novo, sem contar como falha.
Envios de formulário
- Um visitante nunca altera um contacto que já existe. Qualquer pessoa pode escrever o e-mail de outra num formulário aberto. Por isso, o envio de um visitante (ou de um membro com outro e-mail) para um contacto existente passa a ser apenas uma nota no contacto, com o que foi enviado.
- O envio de um membro com sessão iniciada e com o e-mail do próprio perfil preenche as propriedades vazias do contacto (nome, telefone, empresa, cargo) e regista o consentimento. Com Formulários atualizam contactos existentes ligado, também atualiza as que já estavam preenchidas.
- Já tinha ligado o HubSpot? A instalação não recebe o evento automaticamente: abra o HubSpot em Integrações, marque Foi enviado um formulário e guarde. Uma instalação nova já vem com ele.
Problemas comuns
- "O provedor recusou as credenciais." O token foi trocado ou a Private App foi apagada. Cole o token novo e guarde.
- As entregas falham com 403. Falta um dos seis âmbitos. Edite a Private App no HubSpot, marque o que falta e teste de novo.
- A app ficou Com falha. Ver Desligado por falha.