Principal Automação / Integrações Como integrar HeroSpark com Circle

Como integrar HeroSpark com Circle

Última atualização em Jun 13, 2025

É possível integrar a HeroSpark com ferramentas para Comunidades como o Circle.

Passo 1 - Criar Token API no Circle

Em sua conta Circle, acesse o menu principal e clique em Developers.

Acesse o menu Tokens e clique em Create Token.

Selecione a opção Admin v1, escolha um nome para chave e clique em Save.

Ao voltar para tela de Tokens, localize o token criado e clique no local indicado para copiar. Guarde o código para usar nos próximos passos.

Passo 2 - Localizar ID do Comunidade no Circle

Para localizar o ID da comunidade, com a tela do Circle aberta, clique com o botão direito do mouse e selecione a opção Inspecionar.

Ao abrir o inspetor, vários códigos serão exibidos, aperte as teclas Crtl + F para abrir o localizador. Digite Community e no canto direito, utilize a seta para ir na segunda opção.

Abaixo de account: será exibido o ID da Comunidade, copie e guarde o código para os próximos passos.

Passo 3 - Localizar ID do Space no Circle

Para localizar o ID dos Space, clique uma vez sobre o nome para que ele fique selecionado e uma segunda vez com o botão direito do mouse e selecione novamente a opção Inspecionar.

Ao abrir novamente o inspetor, será mostrado na tela o local o nome do Space e um pouco para cima, o ID do Space no campo data=id. Repita a mesma operação para outros Spaces, copie e guarde o ID para usar nos próximos passos..

 

Passo 4 - Criar automação na HeroSpark

Selecione o menu Piloto automático e escolha a automação de sua preferência. É possível utilizar todas as automações de Pagamentos e Recorrências e nesse exemplo, usamos a automação de Pagamento confirmado. Clique em Usar este modelo e na próxima tela, selecione a opção Gerar um Webhook e clique em OK.

Passo 5 - Configurar o Webhook na HeroSpark para Convidar o membro para a Comunidade 

Na tela de Edição e visualização preencha os campos abaixo da seguinte forma:

A. Filtro de disparo: Aplicar em todos os produtos ou filtrar para um produto específico

B. Edição de webhook - URL: https://app.circle.so/api/v1/community_members

C. Método: Post

D. Header - Adicione as duas chaves:

Chave: Content-Type     Valor: application/json

Chave: Authorization       Valor: Cole aqui o Token copiado no Passo 1

 

E. Para automações de Pagamentos do Piloto Automático:

No campo Body, copie e cole o código abaixo:

{

"name": "{{buyer_name}}",

"email": "{{buyer_email}}",

"space_ids": [ ],

"community_id": 

}

Exemplo do Body preenchido:

F.  Para automações de Recorrências do Piloto Automático:

No campo Body, copie e cole o código abaixo:

{

"name":"{{buyerFullName}}",

"email": "{{buyerEmail}}",

"space_ids": [ ],

"community_id": 

}

Exemplo do Body preenchido:

G. Ajuste o código copiado da seguinte forma:

  • community_id: Cole o código copiado no Passo 2

  • space_ids: Cole o código copiado no Passo 3, caso seja mais de um, separe por vírgula.

H. Clique em Automação ativada, em seguida, clique primeiro em Salvar Edição e depois em Testar automação.

Após o testar a automação, acesse o menu Histórico e se as configurações estiverem corretas, o log mostrará o retorno como Executado.

Passo 6 - Configurar o Webhook na HeroSpark para remover o membro da Comunidade

No piloto automático selecione a automação desejada, nesse exemplo, usamos a automação de Chargeback. Na tela de Edição e visualização preencha os campos abaixo da seguinte forma:

A. Filtro de disparo: Aplicar em todos os produtos ou filtrar para um produto específico

B. Edição de webhook - URL: https://app.circle.so/api/v1/community_members

C. Método: Delete

D. Header - Adicione as duas chaves:

Chave: Content-Type     Valor: application/json

Chave: Authorization       Valor: Cole aqui o Token copiado no Passo 1

E. Para automações de Pagamentos do Piloto Automático:

No campo Body, copie e cole o código abaixo:

{

"email": "{{buyer_email}}",

"community_id": 

}

Exemplo do Body preenchido:

F.  Para automações de Recorrências do Piloto Automático:

No campo Body, copie e cole o código abaixo:

{

"email": "{{buyerEmail}}",

"community_id": 

}

Exemplo do Body preenchido:

G. Ajuste o código copiado da seguinte forma:

community_id: Cole o código copiado no Passo 2

H. Clique em Automação ativada, em seguida, clique primeiro em Salvar Edição e depois em Testar automação.

Problemas?

Caso você tenha problemas, entre em contato diretamente com o suporte da HeroSpark.