HubSpot
Ligar o HubSpot em Integrações › Integrações prontas com o token de um Private App e seis escopos. Cria ou atualiza o contato pelo e-mail, registra a compra e a renovação como negócio ganho sem duplicar, marca o status da assinatura e recebe os envios de formulário sem sobrescrever contatos.
O HubSpot recebe os membros como contatos 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 o Private App no HubSpot
Você precisa ser superadministrador da conta do HubSpot.
- No HubSpot, abra Configurações › Integrações › Private Apps e clique em Criar um private app.
- Dê um nome (Memberfy).
- Na aba Escopos, marque os seis:
| Escopo | Para quê |
|---|---|
crm.objects.contacts.read | Achar o contato pelo e-mail |
crm.objects.contacts.write | Criar e atualizar o contato |
crm.objects.deals.read | Achar o negócio de um evento já registrado |
crm.objects.deals.write | Criar o negócio e associá-lo ao contato |
crm.schemas.contacts.write | Criar a propriedade do status da assinatura no contato |
crm.schemas.deals.write | Criar a propriedade que evita negócio duplicado |
- Clique em Criar app e copie o token de acesso. Ele começa com
pat-.
A tela da Memberfy também lista os escopos em Escopos necessários.
2. Ligue na Memberfy
- Em Configuraçõ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ó confere o token: não cria contato.
O que chega
O contato é identificado pelo e-mail.
| Evento | No HubSpot |
|---|---|
| Um membro entrou na comunidade | Cria o contato (nome, sobrenome, 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 contato; o contato fica com o status da assinatura active |
| Uma assinatura foi renovada | Um negócio ganho Renovação: {produto}, do mesmo jeito |
| Uma assinatura foi cancelada | O status da assinatura do contato vira canceled |
| Um formulário foi enviado | Cria o contato com nome, e-mail, telefone, empresa e cargo do formulário e, quando a pessoa aceitou, registra o consentimento. Num contato que já existe, veja abaixo |
- Sem duplicar: cada negócio guarda o evento que o criou (a propriedade Memberfy event id). Uma retentativa ou um Reenviar acha o negócio já criado e não cria outro.
- As duas propriedades, Memberfy subscription status (no contato) e Memberfy event id (no negócio), são criadas sozinhas na primeira vez.
- Telefone: vai no formato internacional (
+5541999998888) quando o membro cadastrou um. Nos outros eventos, ele só entra no contato criado ali; o que já está no HubSpot não é sobrescrito. - 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 contato que já existe. Qualquer pessoa pode digitar 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 contato existente vira só uma nota no contato, com o que foi enviado.
- O envio de um membro logado com o e-mail do próprio perfil preenche as propriedades vazias do contato (nome, telefone, empresa, cargo) e registra o consentimento. Com Formulários atualizam contatos existentes ligado, ele também atualiza as que já estavam preenchidas.
- Já ligou o HubSpot antes? A instalação não ganha o evento sozinha: abra o HubSpot em Integrações, marque Um formulário foi enviado e salve. Uma instalação nova já vem com ele.
Problemas comuns
- "O provedor recusou as credenciais." O token foi trocado ou o Private App foi apagado. Cole o token novo e salve.
- As entregas falham com 403. Falta um dos seis escopos. Edite o Private App no HubSpot, marque o que falta e teste de novo.
- O app ficou Com falha. Ver Desligado por falha.