Integrações

Qualquer sistema entra pelo mesmo webhook assinado.

O vocabulário é de quem manda. A tradução fica na fonte, como dado, e nada do que chega assinado é jogado fora.

Abrir o People Como funciona

Não há conector preso a uma ferramenta: o protocolo é aberto, e qualquer sistema que assine a entrega entra.

Entrada

Um Protocolo Só, Para Toda Fonte

A sua loja, a sua plataforma de aulas, o seu app ou um agente: todos falam do mesmo jeito. O que muda é o vocabulário.

Cada fonte ganha um endereço

Um POST /events/:id e um segredo whsec_ mostrado uma vez. A base legal da fonte é declarada ali mesmo.

Toda entrega vem assinada

Standard Webhooks, com x-ccm-id, x-ccm-timestamp e x-ccm-signature. Fora da janela de 5 minutos, a entrega é recusada.

Reenviar não duplica

O mesmo id é a mesma entrega. Trocar o segredo mantém o anterior valendo por 24 horas, para nada parar no meio.

Standard Webhooks

O Que Chega no People

Uma entrega, de ponta a ponta

O corpo é sempre {type, timestamp, data}. A assinatura é o HMAC-SHA256 de "id.timestamp.corpo" com o segredo da fonte. Qualquer linguagem que calcule um HMAC envia para o People.

http

POST /events/<id-da-fonte>
x-ccm-id: 7d1f0c2e
x-ccm-timestamp: 1759766400
x-ccm-signature: v1,<HMAC-SHA256 em base64>

{
  "type": "aula.concluida",
  "timestamp": "2026-10-06T12:00:00Z",
  "data": {
    "person": { "email": "ana@escola.exemplo" },
    "channel": "web",
    "properties": { "aula": "Primeira aula" }
  }
}

Traduções na fonte

Seu Sistema Não Precisa Mudar de Língua

O vocabulário é de quem manda

Seu sistema fala aula.concluida ou pedido.pago. A fonte guarda a tradução para os tipos do People, e você edita quando quiser.

Nada é descartado

Tipo sem tradução é guardado como chegou e aparece na fonte como "a traduzir". Traduzir relê o que já tinha chegado.

Uma planilha também é fonte

A importação CSV, pelo painel, para quem ainda não tem sistema mandando eventos.

Saída

A Mensagem Sai Com o Seu Domínio, Pela Sua Conta

E-mail pela sua conta

A mensagem aprovada sai pelo Messages, com a chave e o domínio verificado da sua conta. Nunca pelo nosso endereço.

Ou para um destino seu

Um webhook assinado no mesmo protocolo x-ccm. O que acontece do outro lado é decisão sua.

Sem canal, espera

Sem canal configurado, a mensagem fica aprovada esperando, e o painel diz por quê.

Toda saída é uma ação: nada vai para uma pessoa sem passar pela checagem sem IA, e falar com ela começa pedindo a sua confirmação.

Para o seu agente

O Seu Agente Lê e Propõe. Nenhuma Ferramenta Envia Nada a Uma Pessoa.

Leitura

people_list_people, people_get_person e people_get_timeline: a lista de pessoas, a ficha e a linha do tempo.

Escrita que só propõe

Com permissão de escrita, people_add_note e people_propose_action. A proposta entra na mesma fila e passa pela mesma checagem.

Quem está conectado

Em Equipe, todo cliente MCP que a conta já viu, com revogar e restaurar, e as rotinas que rodam sozinhas.

O servidor MCP fica em https://people.worker.mycustomers.click/mcp, com o mesmo login do painel, por OAuth.

Qualquer sistema entra pelo mesmo webhook assinado.

O endereço e o segredo de cada fonte ficam em Dados, no painel. Você entra com um código que chega no e-mail.

Abrir o People Como funciona