Customers · People

A ficha de cada pessoa, do primeiro toque ao pagamento.

Tudo o que a pessoa fez chega por eventos de qualquer sistema, o estágio sai do que ela fez, e agentes dão o próximo passo, sozinhos ou passando por você.

Você entra com um código que chega no e-mail. Uma base por conta, sem workspace e sem seletor de contexto.

Por que isso existe

Saber quem é a pessoa é fácil. Difícil é saber EM QUE MOMENTO ELA ESTÁ.

Lead, prospect e customer são a mesma pessoa em três momentos, e o mercado vende uma ferramenta para cada um. O resultado é a mesma história partida em três lugares, com um estágio que alguém precisa lembrar de digitar.

  • A coluna "estágio" da planilha está certa no dia em que alguém atualiza
  • A mesma pessoa aparece duas vezes, com e-mails diferentes
  • Quem pagou e não começou a usar só aparece quando pede o dinheiro de volta

O caminho inteiro

Eventos entram, a ficha se monta, o agente propõe.

Quatro blocos, e só o primeiro pede você no painel.

1 · Criar a fonte

Cada sistema seu ganha um endereço e um segredo

A fonte nasce no painel com um nome e a base legal declarada: contrato, interesse legítimo ou consentimento. O segredo aparece uma vez; trocar mantém o anterior valendo por 24 horas, para nada parar no meio.

painel
Painel › Dados › Fontes › Nova fonte

nome         Plataforma de aulas
base legal   contrato

-> endereço   https://people.worker.mycustomers.click
             /events/<id-da-fonte>
-> segredo    whsec_…   (aparece uma vez)

2 · Mandar o evento assinado

Qualquer linguagem que calcule um HMAC envia para o People

Standard Webhooks com os cabeçalhos x-ccm, e o corpo é sempre {type, timestamp, data}. Fora da janela de 5 minutos, a entrega é recusada; o mesmo id de novo é reenvio e não duplica. O tipo é o vocabulário do seu sistema.

javascript
import { createHmac, randomUUID } from 'node:crypto'

const id = randomUUID()
const timestamp = Math.floor(Date.now() / 1000)
const body = JSON.stringify({
  type: 'aula.concluida',
  timestamp: new Date().toISOString(),
  data: {
    person: { email: 'ana@escola.exemplo' },
    channel: 'web',
    properties: { aula: 'Primeira aula' },
  },
})
const key = Buffer.from(SECRET.slice(6), 'base64')
const sig = createHmac('sha256', key)
  .update(`${id}.${timestamp}.${body}`)
  .digest('base64')

await fetch(SOURCE_URL, {
  method: 'POST',
  headers: {
    'x-ccm-id': id,
    'x-ccm-timestamp': String(timestamp),
    'x-ccm-signature': `v1,${sig}`,
  },
  body,
})

-> 200 { accepted: 1, duplicates: 0,
        events: [{ personId, stage: 'lead',
          type: 'aula.concluida',
          translated: false, … }] }

3 · Ou importar a planilha

A lista que você já tem entra como está

Uma fonte do tipo importação recebe CSV pelo painel, com cabeçalhos em português ou em inglês. Cada linha vira o primeiro toque da pessoa, com identidade, empresa e origem.

csv
nome,email,telefone,empresa,utm_source
Ana Souza,ana@escola.exemplo,,Escola Exemplo,instagram
Bruno Lima,,+55 11 90000-0000,,indicacao
Carla Dias,,,,

-> 2 pessoas, cada uma com o primeiro toque
-> linha 4 pulada: sem e-mail nem telefone
-> importar de novo: nada muda

4 · Conferir na ficha

O objeto que você confere: a ficha, com a linha do tempo

Cada evento cai na ficha da pessoa certa e o estágio se recalcula. Escolhida a primeira aula como ativação, a primeira vez que ela acontece vira account.activated naquele momento.

ficha
Ana Souza                        prospect
ana@escola.exemplo · Escola Exemplo

linha do tempo
  person.touched      importação   lead
  account.created     web          prospect
  aula.concluida      web
  account.activated   1ª aula      ativou

próximo passo
  Ajuda com o segundo módulo
  [Feito]  [Trocar]

Model Context Protocol

O seu agente lê a ficha e escreve a próxima ação. A checagem vem antes de tudo.

São cinco ferramentas, autenticadas por OAuth 2.1 com o mesmo login do painel. Com leitura, people_list_people, people_get_person e people_get_timeline. Com escrita, people_add_note e people_propose_action, que entram na mesma fila e passam pela mesma checagem.

O que o servidor NÃO oferece

  • Nenhuma ferramenta fala com uma pessoa não há envio pelo MCP, e não haverá: um agente propõe, e a mensagem sai só depois da checagem e da sua aprovação.
  • A conta nunca é argumento ela vem do token. Um texto malicioso que o agente leia não consegue apontar uma ferramenta para a base de outra conta.
  • Apagar não existe como ferramenta nem criar fonte, nem ler segredo. Excluir uma pessoa continua sendo seu, no painel, digitando o nome dela.

Em Equipe, o painel mostra quem está conectado todo cliente MCP que a conta já viu, com revogar e restaurar. Revogado, cada chamada dele responde 401 até alguém permitir de novo.

O que ele não faz

Dito Antes, Para Ninguém Descobrir Depois

As linhas que pesam contra continuam na tabela. É o que faz as outras valerem alguma coisa.

Mensagem por celular, ligação ou conversa ao vivo

Não

A mensagem sai por e-mail pela sua conta, ou para um destino seu por webhook assinado. O que acontece do outro lado é decisão sua.

Conector pronto para outra ferramenta

Não. Um protocolo aberto

Nenhuma ferramenta de terceiro é "integrada". Qualquer sistema que assine a entrega entra, e o vocabulário dele fica traduzido na fonte.

Nota de interesse ou dado comprado de fora

Não

O estágio vem dos eventos; não há pontuação calculada por modelo, dado comprado de terceiro nem fingerprint.

Chave de API que administra a conta

Não

A chave de leitura só lê. A chave de agente lê, propõe ações e anota na ficha, pela mesma conferência dos agentes, e não aprova nada. Criar, alterar e aprovar é com o login de uma pessoa.

Fusão automática de fichas

Nunca

Vira sugestão de fusão, e quem decide é você.

Agente que manda uma oferta de preço

Você escolhe

Na Aprovação Automática sai sozinha; em Passa por você, espera a sua aprovação.

Se alguma destas linhas não bater com o que você encontrou na prática, conte nos canais da página de contato. A linha é conferida e corrigida.

Preço

Comece grátis. Pague pelas fontes, não pelas pessoas.

Grátis

Sem custo

1 fonte · sem cartão · não expira

Starter

R$ 29,99 por mês

3 fontes · R$ 299,99 no anual

Pro

R$ 49,99 por mês

9 fontes · R$ 499,99 no anual

Scale

R$ 99,99 por mês

99 fontes · R$ 999,99 no anual

Uma fonte é cada sistema que manda eventos ou cada planilha importada. Pessoas, eventos, importações, agentes, estratégias e o MCP não têm limite de plano. No limite, as fontes que você já tem continuam recebendo; só a próxima espera o plano.

Grátis, sem cadastro

Antes de abrir o People, resolva uma coisa agora

Link e QR code

Gerador de link de WhatsApp

O link wa.me com a mensagem já escrita e o QR code para imprimir, na hora.

Usar agora

QR code

QR Code do WhatsApp

O QR code que abre a sua conversa no WhatsApp, com a mensagem pronta, para imprimir em PNG ou SVG.

Usar agora

Planilha e CSV

Limpar lista de contatos

Telefones com +55 e DDD, o nono dígito de volta e os duplicados fora, numa planilha só.

Usar agora

Perguntas

As objeções, na ordem em que elas aparecem

Achou um limite que não está escrito aqui?

Os canais estão na página de contato. Se você encontrou onde quebra, a linha entra nesta página antes do próximo visitante descobrir sozinho.

Crie a primeira fonte e veja a primeira ficha se montar.

Você entra com um código que chega no e-mail. A fonte, a importação, o Manual e a fila de aprovação estão no painel.