Pular para o conteúdo
Customers
CRM simples que recebe os cadastros do meu app sozinho e mostra quem nunca pagou

CRM simples que recebe os cadastros do meu app sozinho e mostra quem nunca pagou

Como o app manda cada cadastro e cada pagamento para uma ficha por pessoa, e o estágio separa quem só criou conta de quem pagou, sem digitar nada e sem conector pronto.

Ciro Cesar Maciel5 min de leituraFeito com ajuda de IA

Nesta página · 9 seções
  1. A ideia: o estágio sai dos eventos
  2. Passo a passo
  3. Como a ficha encontra a pessoa certa
  4. E depois de saber quem não pagou
  5. O que o People não tem
  6. Perguntas frequentes
  7. Para continuar lendo
  8. Quem nunca pagou, numa lista que se atualiza sozinha
  9. Fontes

O app tem cadastros, alguns pagam e a maioria não. Você quer uma lista simples: quem criou conta, quem chegou a usar e quem nunca pagou, para saber com quem falar hoje. Os CRMs conhecidos resolvem isso com formulário, digitação ou uma integração por ferramenta de automação, e no fim alguém precisa manter a planilha em dia. O caminho mais curto é o app mandar os fatos sozinho, no momento em que acontecem.

A ideia: o estágio sai dos eventos

No People, ninguém arrasta um cartão de coluna. O estágio de cada pessoa é derivado dos eventos que chegaram:

EventoEfeito
o primeiro evento qualquera pessoa é lead
account.createdprospect
account.activatedcontinua prospect, com a ativação marcada
subscription.paidcustomer, e esta é a única forma
subscription.canceled depois de customervolta a prospect

"Quem nunca pagou" vira uma pergunta exata: quem é prospect. E "quem criou conta e nem chegou a usar" é quem é prospect sem ativação. O que conta como ativar é você que escolhe, por exemplo o primeiro projeto criado ou a primeira aula concluída.

Customer nunca é manual. Uma pessoa só vira cliente porque o pagamento aconteceu, e não porque alguém achou que ela pagaria.

Passo a passo

1. Criar a fonte

No painel do People, em Dados › Fontes, você cria uma fonte com nome e base legal. Nessa hora aparecem o endereço POST /events/<id-da-fonte> e um segredo que começa com whsec_. O segredo aparece uma única vez: ele vai para as variáveis de ambiente do app.

2. Enviar os eventos do app

O protocolo é um só, Standard Webhooks com o prefixo x-ccm: três cabeçalhos com o id da entrega, o horário e a assinatura HMAC do corpo. O corpo diz o tipo, o horário e quem é a pessoa:

{ "type": "account.created",
  "timestamp": "2026-10-07T12:00:00Z",
  "data": { "person": { "email": "ana@escola.exemplo", "name": "Ana Souza" } } }

O agente que escreveu o app escreve também esse envio: a documentação em https://mycustomers.click/products/people/llms.txt tem o exemplo completo em Node. Os pontos que mais dão erro são três: assinar com o segredo sem o prefixo whsec_, assinar exatamente o mesmo texto que é enviado e usar o relógio do servidor. Reenviar o mesmo id de entrega não duplica: o People trata como reenvio.

Se o sistema já tem nomes próprios para os eventos, como usuario.criado, não é preciso mudar o código. A fonte guarda um mapa de tradução para os tipos do People, e um tipo sem tradução é guardado como chegou, sem nada ser descartado.

3. Trazer a planilha que já existe

Cadastros antigos entram por uma fonte de importação, com um CSV de cabeçalhos em português ou em inglês: e-mail, nome, telefone, empresa, origem e campanha. Importar o mesmo arquivo de novo não muda nada, porque o id de cada linha é o e-mail ou o telefone.

Como a ficha encontra a pessoa certa

Um evento só se junta a uma ficha por identidade igual: o mesmo e-mail, o mesmo telefone ou o mesmo id do seu sistema. Quando um evento aponta para duas fichas, ele vai para a mais forte, e o People sugere juntar as duas. Duas fichas nunca se fundem sozinhas: juntar é uma ação que pede confirmação.

E depois de saber quem não pagou

A ficha mostra a linha do tempo de cada pessoa e um próximo passo. Os agentes do People propõem esse passo: uma mensagem de boas-vindas, uma resposta, uma oferta. Toda ação passa antes por uma checagem sem IA, com horário de silêncio, limite de contatos por semana e o que o seu Manual proíbe prometer.

Um ponto para decidir logo no começo: a Aprovação da conta vem em Automática, e nesse modo as ações dos agentes saem sozinhas. Se você quer aprovar cada mensagem, troque para Passa por você. As mensagens saem por e-mail com o seu domínio verificado no Messages, ou para um webhook seu; sem canal configurado, ficam esperando, e o painel diz por quê.

O que o People não tem

Não há conector pronto para ferramenta nenhuma, nem conexão automática com login ou cobrança: o que existe é o protocolo aberto, e qualquer sistema que assine a entrega entra. Não há chave de API que escreve: a única chave, prk_, só lê. Também não há lead score, enriquecimento com dado de terceiro, SMS ou mensageiro.

Perguntas frequentes

Preciso de Zapier ou de outra ferramenta de automação?

Não. O próprio backend do app envia o evento numa chamada HTTP assinada. Uma ferramenta de automação também funciona, desde que assine a entrega.

Os produtos do Infrastructure mandam eventos para o People?

Auth, Forms, Videos, Tasks, Blogs, Pages, Links e Newsletter enviam webhooks no mesmo protocolo, com um botão "Enviar teste" que o People reconhece e não grava. O endereço da fonte entra como destino do webhook do produto.

Um agente consegue perguntar quem não pagou?

Sim. O People tem um servidor MCP: o agente conecta com o seu login no navegador, lê a base e responde "quem criou conta nesta semana e ainda não pagou?".

O que o plano conta?

Só as fontes, ou seja, cada sistema que manda eventos e cada planilha importada. Pessoas, eventos, importações, agentes e o MCP não têm limite de plano.

Para continuar lendo

Quem nunca pagou, numa lista que se atualiza sozinha

O People recebe os eventos do seu app, monta uma ficha por pessoa e deriva o estágio do que aconteceu, para você saber com quem falar hoje. Conhecer o People

Fontes

XLinkedInWhatsAppE-mail

Quem escreveu

Ciro Cesar Maciel

Sou marido, pai e trabalho com tecnologia há mais de duas décadas, construindo sistemas para grandes empresas e liderando times técnicos. Desde 2024 desenvolvo ferramentas digitais e aplico Inteligência Artificial para viver e trabalhar com mais clareza, e escrevo aqui sobre isso.

Todos os textos

Continue lendo

Comentários

Seu e-mail fica com Customers para moderar e responder. O comentário aparece depois de aprovado.