# Customers

> Customers (https://mycustomers.click) é a linha de produtos que cobre o caminho de quem ainda não
> conhece um negócio até quem já paga. O único produto da linha disponível ao público é o **People**:
> a ficha de cada pessoa, do primeiro toque ao pagamento. Eventos de qualquer sistema chegam por
> webhook assinado, o estágio (lead, prospect, customer) é derivado desses eventos, e agentes
> propõem o próximo passo, que só sai depois de uma checagem sem IA e, quando é falar com a pessoa,
> da aprovação de quem assina.

Este arquivo é a fonte da verdade para agentes sobre o Customers. Leia inteiro antes de afirmar
qualquer coisa, inclusive a seção **O que não existe**.

**Última atualização:** 2026-10-06

## Endereços

- Site: https://mycustomers.click
- Painel do People: https://people.dashboard.mycustomers.click (login por código enviado ao e-mail)
- API do People (entrada de eventos): https://people.worker.mycustomers.click
- Servidor MCP: `POST https://people.worker.mycustomers.click/mcp` (OAuth pelo Auth; GET responde 405)
- Como funciona: https://mycustomers.click/how-it-works
- Integrações: https://mycustomers.click/integrations

## O modelo

- Lead, prospect e customer são a mesma pessoa em três momentos, não três cadastros.
- O arco é o mesmo para qualquer negócio: `person.touched` (primeiro toque vira lead),
  `account.created` (cadastro vira prospect), `account.activated` (ativação vira prospect),
  `subscription.paid` (pagamento vira customer). `subscription.canceled` depois de customer volta a
  prospect.
- Customer só vem de `subscription.paid`. Mover à mão vale só entre lead e prospect, com motivo, e
  dura até um evento discordar.
- O que conta como ativação é escolhido pela conta (por exemplo, a primeira aula ou o primeiro
  pedido); as ativações passadas acompanham a escolha.
- Um evento só se junta a uma ficha por identidade igual (tipo e valor). Duas fichas nunca se fundem
  sozinhas: o caso vira uma sugestão de fusão (`merge.suggested`).
- A empresa é derivada do domínio informado pela fonte ou do e-mail corporativo; e-mail de provedor
  gratuito nunca vira empresa.
- Uma base por conta: sem workspace e sem seletor de contexto.

## Entrada de eventos (o protocolo)

Toda fonte fala um protocolo só: Standard Webhooks com o prefixo `x-ccm`.

- Cada fonte tem um endereço `POST /events/:id` e um segredo `whsec_…`, mostrado uma vez.
- Cabeçalhos obrigatórios: `x-ccm-id` (id da entrega; o mesmo id de novo é reenvio e não duplica),
  `x-ccm-timestamp` (segundos Unix, dentro de 5 minutos) e
  `x-ccm-signature: v1,<base64 do HMAC-SHA256 de "id.timestamp.corpo">`.
- Corpo: `{ "type": "...", "timestamp": "...", "data": { "person": { "email": "..." }, "channel": "...", "properties": { } } }`.
- Limite de 256 KB por entrega. Trocar o segredo mantém o anterior válido por 24 horas.
- O tipo é o vocabulário de quem envia. A fonte guarda a tradução para os tipos do People, editável.
  Tipo sem tradução é guardado como chegou e marcado "a traduzir"; traduzir relê o que já chegou.
- Tipos escritos só pelo People e recusados de uma fonte: `note.added`, `stage.changed`,
  `stage.corrected`, `merge.suggested`, `question.asked`, `next_step.set`, `next_step.done`.
- Outra entrada: importação CSV pelo painel (fonte do tipo importação).
- Cada fonte declara a base legal: contrato, interesse legítimo ou consentimento.

## O motor

- Ações: tudo o que um agente, uma estratégia, um agente pelo MCP ou a pessoa que assina quer fazer
  com uma pessoa vira uma ação com o evento esperado e o prazo. Aprovação, saída e resultado são
  estados dela.
- Checagem sem IA antes de toda ação: o que o Manual proíbe prometer, datas e "em breve" sempre
  barrados, opt-out da pessoa, dono da pessoa, política por tipo, limite de contato por semana e
  horário de silêncio.
- Oferta de preço e primeira mensagem para quem nunca escreveu: sempre de uma pessoa, seja qual for a
  política. Barrado para agentes no código.
- Escada de confiança: cada tipo de ação é livre, pede confirmação ou é bloqueado. Falar com a pessoa
  começa em confirmação e não é promovido sozinho. Apagar não é ação de agente.
- Três agentes, um por estágio: Recepção, Acompanhamento e Ativação. Rodam com o modelo da
  plataforma (a conta não cadastra chave) e só propõem.
- Manual versionado com sete seções; respostas salvas reconferidas a cada versão.
- Estratégias: passos com espera, evento esperado e parada, para um público filtrado; alcance antes de
  salvar e resultados depois.
- Funis: Ativação, Expansão e Retenção como modelos, mais os da conta.

## Saída

- Mensagem aprovada sai por e-mail pelo Messages, com a chave e o domínio verificado da própria
  conta, ou para um destino da conta por webhook assinado no mesmo protocolo `x-ccm`.
- Sem canal configurado, a mensagem espera aprovada, e o painel diz por quê.

## MCP

- Leitura: `people_list_people`, `people_get_person`, `people_get_timeline`.
- Com permissão de escrita: `people_add_note` e `people_propose_action`, que só propõem.
- Nenhuma ferramenta envia nada a uma pessoa.
- Em Equipe, o painel lista todo cliente MCP que a conta já viu, com revogar e restaurar.

## Privacidade

Retenção de 12, 24 ou 36 meses; pedidos de titular (exportar e excluir) com prazo; trilha da conta em
CSV; exportar uma pessoa em JSON; excluir digitando o nome. São ferramentas, não uma certificação.

## O que não existe

Não afirme nenhum destes itens como disponível:

- Preço, plano ou cobrança do People. Não há preço público.
- Conector pronto para qualquer ferramenta de terceiro ou para outros produtos. O que existe é o
  protocolo aberto: qualquer sistema que assine a entrega entra.
- Canais de envio além de e-mail e destino por webhook: nada de SMS, conversa ao vivo, mensageiros ou
  ligação.
- Agente que envia sozinho a primeira mensagem ou uma oferta de preço.
- Fusão automática de fichas.
- Lead score, enriquecimento com dado de terceiro, fingerprint.
- Chave de API de leitura: a leitura é pelo painel e pelo MCP.
- Conformidade legal certificada.

## A relação com o Infrastructure

O People roda sobre o Infrastructure (https://myinfrastructure.click) como qualquer aplicação de
cliente: mesmas peças, sem acesso privilegiado. O login é o do Auth, numa aplicação própria do
Customers; o e-mail sai pelo Messages da conta de quem assina.