APIs, SDKs & automação

Seu stack chama a Personyze.
Ou ela chama seu stack.

Uma API REST sobre todos os objetos da conta, SDKs de servidor para Node, PHP e Python, SDKs mobile nativos, uma API JavaScript no cliente e um servidor MCP para assistentes. E ainda regras de automação e relatórios agendados que continuam rodando quando ninguém está com o painel aberto.

Leia a documentação →Agendar uma demo

4.8

4.6

1Um ID, no seu site

RESTSERVIDOR

NorthwindComece grátis

Para equipes com mais de 200

Preço por volume, não o plano inicial.

Você viu o Enterprise duas vezes esta semana. Veja quanto custa com 240 licenças.

Ver seu preço

Escolhido para sua equipePorque você está avaliando o Enterprise

Marco ReyesTerceira visita · teste acaba sextaviu Enterprise240 licençassem cartão cadastradovis_8f21c6

Decidido no seu servidor antes de a página ser desenhada — o Marco nunca viu o preço inicial.

2O mesmo ID, no seu app

SDK NATIVOiOS / ANDROID

Um rack de servidores — Seu servidorRespondido em 40 ms, do seu próprio data centerdecide(user)node / php / pythonplan: "volume", seats: 240

uma chamada https

9:41

Northwind

Para o tamanho da sua equipe

Preço por volume para 240 licenças

A oferta que você estava lendo ontem à noite.Ver a cotação

Licenças em uso240

Seu gerente de contasRosa

InícioUsoFaturamentoVocê

A mesma decisão, pedida pelo celular — sem webview, e o motor é o seu próprio servidor.

3De agente para agente

MCPOAUTH 2.1

Seu assistentePersonyze MCP · conectado

De quem é o teste que acaba esta semana sem cartão cadastrado?

personyze › list_visitors3 encontrados · 240 ms

Três, e vale ligar para o Marco Reyes hoje — terceira visita na semana, já com preço para 240 licenças, e o teste dele acaba na sexta.

Marco ReyesSexta · 240 licençasvis_8f21c6

Priya RaghavanSexta · 40 licençasvis_1c07ba

Tom OkaforDomingo · 12 licençasvis_4de920

leitura + escrita, limitadassuas permissões, revogáveis com um clique

A mesma decisão, entregue a um assistente — por um protocolo aberto, não por uma tela raspada.

4Para sua equipe

REGRA DE AUTOMAÇÃOWEBHOOK

#new-businessRegra de automação

O Marco Reyes parece pronto para comprar.

Terceira visita na semana, com preço para 240 licenças, ainda sem cartão — e o teste dele acaba na sexta.

teste acaba em 2 diasviu Enterprise duas vezessem cartão cadastrado

Abrir a conta dele

POST /your-webhookdisparado por uma regra, sem ninguém olhando o painel

A regra que disparou

teste acaba em 2 diaseviu Enterpriseesem cartão

Verificado a cada hora. Ninguém estava com o painel aberto.

Rosa IbarraGerente de contas · avisada três minutos depoisum nome, não um relatório

A mesma decisão, uma última vez — como motivo para a pessoa que pode pegar o telefone.

5E qual venceu

A / BRELATÓRIO AGENDADO

NorthwindVisão geralCampanhasExperimentosRelatóriosConfigurações

Teste de preços Enterprise

Variação A

Você passou do Growth em 40 licençasVeja quanto custa parar de se preocupar

4.1%para cotação

VencedoraVariação B

Preço por volume para 240 licençasO plano para equipes do seu tamanho

6.8%para cotação

+66%2.140 visitantes · 97% de confiança · decidido no dia 6significativo

personyze.decide(user)serve a vencedora daqui em diante, sem novo deploy

Relatório agendadoSegunda 08:00 · para 4 pessoas, sem ninguém exportar

48cotações geradas+22%11testes convertidos+4$18,400receita nova+31%

A mesma decisão, testada e contabilizada — uma vencedora, servida por todos os chamadores ao mesmo tempo.

Um motor, muitos chamadores

Chame de qualquer lugar. A mesma decisão.

O modelo de públicos, a segmentação e os relatórios são os mesmos do painel. O que muda é quem pergunta e o que exibe a resposta.

Do seu próprio servidorUma chamada de volta e você renderiza — sem navegador envolvido

De dentro do seu appA mesma decisão, em JSON, no iOS e no Android

De um assistenteOs mesmos objetos de novo, desta vez como ferramentas

Seu servidor pergunta

POST /rest/decide { "user_id": "u_8241", "session_id": "s_5f3a91", "page": "/pricing" }

Quem chama fornece o id e mantém a sessão. Ela expira depois de 90 minutos.

A Personyze responde

{ "actions": [{ "audience": ~~"Enterprise, em avaliação"~~, "show": ~~"pricing-cta-b"~~, "goal": ~~"demo_request"~~ }], "dismissed": [~~"welcome-bar"~~] }

Qual público correspondeu, o que mostrar, o que já foi fechado. Você renderiza.

Renderizado pelo seu app

iOS nativo, Android e React Native, cada um com suas próprias APIs de tracker, condições e ações.

Mesmo endpoint, mesmo formato

{ "actions": [{ "type": ~~"card"~~, "slot": ~~"home_top"~~, "items": [ … ] }] }

Sem webview e sem HTML. O app recebe JSON e desenha com os próprios componentes, então continua com a cara do seu app.

Seu assistenteConectado via MCPleitura + escrita, limitadas

Quais campanhas perderam tráfego na semana passada, e o que devo testar agora?

get_traffic_analyticsTrês perderam espaço, e a de preços foi a que mais perdeu. É também a página onde seu público Enterprise mais chega. Ele pode montar esse teste e mandar para staging sem ninguém abrir o painel.

Página de preços−18%

Checkout−12%

Categoria−6%

Os mesmos objetos que a API REST expõe — desta vez como ferramentas, com as permissões que você concedeu.

SDKs e endpoints

Três versões de um endpoint.

No servidor, no app ou na página. Escolha conforme o lugar onde a decisão precisa chegar.

No servidor

Node, PHP e Python

Um endpoint JSON em três versões. Quem chama fornece o id do usuário e carrega um id de sessão opaco, então funciona para um quiosque, um set-top box ou uma página que seu framework renderiza antes de qualquer navegador vê-la.

decide()identify()track()

Celular

iOS, Android, React Native

SDKs nativos com APIs próprias de tracker, condições e ações — os mesmos públicos e as mesmas metas do site, retornados como JSON que seus componentes desenham.

trackercondiçõesações

Na página

API JavaScript no cliente

Leia o perfil, dispare uma meta, peça uma decisão ou rode de novo um posicionamento a partir do seu próprio script — útil quando a página é uma single-page app e nada recarrega.

perfilmetasposicionamentos

1,500+

Marcas que usam a Personyze em produção

4.6/5

G2CapterraCrozdesk

Avaliação média no G2, Capterra e Crozdesk

Zero exportações

Sem sincronização noturna e sem uma segunda cópia do perfil ficando desatualizada

Uma chave

Tudo o que o painel edita, em um só endpoint.

Não é um feed somente leitura do que aconteceu. São os mesmos objetos, criados e alterados pelo seu próprio código.

Campanhas e açõesCAMPANHAS · AÇÕESPúblicos e membrosPÚBLICOS · MEMBROSVisitantes e seus camposVISITANTES · CAMPOSCatálogos de produtos e artigosPRODUTOS · ARTIGOSMetas e conversõesMETAS · CONVERSÕESRelatórios e analyticsRELATÓRIOS · ANALYTICS

CAMPANHAS · AÇÕESlercriaralterar

Tudo o que a tela de campanhas edita, pelo seu próprio código.

Crie uma campanha, adicione ações, altere o conteúdo delas e ative-as. São os mesmos registros que o painel grava, com o mesmo versionamento por baixo, então uma edição feita por script pode ser recuperada exatamente como uma feita por uma pessoa.

O que você pode fazer4

Criar um rascunho e deixá-lo desativado até alguém revisar.
Substituir conteúdo em uma ação sem mexer na campanha ao redor.
Distribuir tráfego entre variações, ou deixar a divisão com o motor.
Duplicar uma campanha para outra conta sua.

Bom saber2

O versionamento é por ação — uma mudança de conteúdo cria uma versão, e a versão no ar é a que os visitantes recebem.
Gravações diretas no banco de dados nunca são replicadas — use a API ou o painel, senão os visitantes continuam vendo o conteúdo antigo.

GET POST PUT /rest/campaigns

PÚBLICOS · MEMBROSlercriaralterar

Segmentos que você monta, ou segmentos que você alimenta.

Um público pode ser um conjunto de condições que o motor avalia, ou uma lista estática que seu próprio sistema mantém em dia adicionando e removendo membros conforme as pessoas se qualificam. Os dois tipos servem para segmentar qualquer coisa na plataforma.

O que você pode fazer3

Definir condições sobre comportamento, campos do CRM, localização, dispositivo ou valor do carrinho.
Enviar membros um por um ou em lote, e removê-los quando deixarem de se qualificar.
Agrupar páginas para que uma regra signifique "as páginas de preços" em vez de uma lista de URLs.

Bom saber2

Um público estático é mantido por você — nada expira os membros por você.
As condições são as do painel — os mesmos operadores, então um segmento se lê igual nos dois lugares.

POST /rest/audience_members

VISITANTES · CAMPOSlercriaralterar

Um perfil, seja quem for que pergunte.

Leia um perfil, grave nele seus próprios campos ou entregue ao motor uma identidade do seu CRM, para que o site, o app, o email e um webhook falem da mesma pessoa em vez de quatro sessões anônimas.

O que você pode fazer3

Identificar um visitante com seu próprio id de usuário ou um hash de email.
Gravar campos personalizados no perfil — plano, licenças, data de renovação, tudo o que seu sistema sabe e o navegador não.
Ler o perfil de volta para decidir algo no seu próprio código.

Bom saber2

A identidade é a chave de junção — passe a mesma em todo lugar e há um perfil; passe diferentes e há vários.
Uma sessão no servidor dura 90 minutos a partir da última chamada, ligada a essa identidade.

POST /rest/identify

PRODUTOS · ARTIGOSlercriaralterar

Seu catálogo, ordenado para uma pessoa.

Envie produtos ou artigos, mantenha preços e estoque atualizados e deixe o motor de recomendação ordenar pelo que você realmente vende hoje, e não por uma exportação noturna do que vendeu ontem.

O que você pode fazer3

Inserir ou atualizar itens com seus próprios atributos, não só título e preço.
Atualizar estoque e preço separadamente, sem reenviar o catálogo.
Apontar para um feed e deixar que ele atualize de forma agendada.

Bom saber2

Sem estoque é um filtro, não uma exclusão — o item mantém o histórico e volta a ser ranqueado assim que retorna.
Artigos são ranqueados pelo mesmo motor que os produtos, então conteúdo e comércio podem ficar em um só widget quando você quiser.

PUT /rest/products

METAS · CONVERSÕESlercriaralterar

O que conta, registrado onde acontece.

Defina o que é uma conversão e registre-a a partir do seu servidor quando ela acontecer num lugar que o navegador nunca veria — um pedido por telefone, um contrato assinado, um reembolso que deveria tirar uma do placar.

O que você pode fazer3

Registrar uma conversão com valor e moeda, a partir de qualquer chamador.
Atribuí-la à identidade do visitante que você já passa em todos os outros lugares.
Ler as metas de volta para que o seu dashboard e o nosso contem a mesma coisa.

Bom saber2

Uma meta registrada duas vezes conta duas vezes — envie sua própria chave de idempotência se quem chama puder tentar de novo.
A receita é opcional mas é ela que transforma um resultado de A/B em um número sobre o qual alguém fora do marketing vai agir.

POST /rest/goal_reached

RELATÓRIOS · ANALYTICSlercriaralterar

Os mesmos números que as telas mostram.

Desempenho de campanhas, tráfego, estatísticas de produtos e resultados de A/B, com as definições de métricas do painel. Consulte quando quiser ou agende o envio para pessoas que nunca vão fazer login.

O que você pode fazer3

Obter um relatório por id, para qualquer período que a tela ofereça.
Agendar um diário, semanal ou por campanha, para uma lista de endereços.
Ler resultados de A/B incluindo a confiança, para que suas próprias ferramentas decidam.

Bom saber2

Somente leitura, de propósito — os números são derivados, então não há nada para gravar aqui.
As definições são as do painel — o número que você obtém é o mesmo que outra pessoa vê na tela, e é exatamente essa a ideia.

GET /rest/reports/:id

Continua rodando

Regras, testes e relatórios que não precisam de você.

As partes que deveriam acontecer sem ninguém precisar decidir — e a vencedora indo ao ar sozinha assim que vence.

Regras de automação

Se isto, então aquilo

Observe um segmento, uma meta ou um feed e aja com base neles — ative uma campanha, mova alguém para uma lista, envie um evento para seu analytics. A regra roda no horário que você definir, não quando alguém se lembra.

gatilhoscondiçõesações

Relatórios agendados

Chega antes da reunião

O relatório que você teria exportado, enviado de forma agendada para quem pede — com os mesmos detalhamentos e as mesmas definições de métricas da tela de onde veio.

diáriosemanalpor campanha

Experimentos

Duas versões, uma vencedora

Divida o tráfego entre variações, acompanhe os números onde você já acompanha e deixe o motor servir a vencedora quando tiver certeza. Todos os chamadores começam a servi-la no mesmo instante — nada para refazer deploy, nada para lembrar.

divisãosignificânciaauto-serve

Assistentes

Ou deixe um assistente fazer as perguntas.

O servidor MCP coloca a conta atrás de um protocolo aberto, para que Claude, ChatGPT ou qualquer cliente MCP possa lê-la e alterá-la conversando — com as permissões que você concedeu, e revogável separadamente.

MCP

Pergunte sobre a conta

“Quais campanhas perderam espaço este mês?” — e ele lê os mesmos números de desempenho que o painel mostra, não um print deles.

MCP

Peça o rascunho

Um rascunho de campanha, um público a partir de uma descrição, um grupo de páginas, uma meta. Volta como rascunho para você abrir e conferir, não como algo já no ar.

MCP

Deixe-o agir com base no que encontrou

Mover alguém para um público, ativar uma campanha, alterar um conteúdo, abrir um ticket de suporte — cada um é uma ferramenta que precisou ser autorizada.

Conheça o servidor MCP →

Acesso

Duas formas de acesso, revogadas separadamente.

O que autentica um servidor não é o que autentica um assistente, e isso é proposital.

Para o seu próprio códigoUma chave de API de servidor

Onde ficaNo seu servidor, nunca numa página

AlcanceTodos os objetos da conta

RotaçãoSem mexer no seu código

Para um assistenteUma autorização OAuth 2.1

Onde ficaNo cliente MCP, nunca com você

AlcanceSó as ferramentas que você permitiu

RevogaçãoSeparadamente, sem trocar a chave

Nos dois casos, uma decisão no servidor roda em uma janela de sessão de 90 minutos ligada à identidade que você passa — então um celular, uma página e um webhook podem ser a mesma visita.

Perguntas

O que as pessoas perguntam antes de integrar.

Respondido do jeito que responderíamos numa ligação.

Preciso usar a tag JavaScript?

Não. A API REST e os SDKs de servidor tomam uma decisão a partir do seu próprio servidor e entregam o conteúdo para você renderizar — nada precisa rodar no navegador. A maioria das contas usa os dois: a tag para o sinal de comportamento, a API para as decisões que querem controlar.

Como a mesma pessoa continua sendo a mesma pessoa?

Você passa uma identidade — seu id de usuário, um hash de email, o que seu sistema já usa. Todo chamador que passa a mesma identidade lê e grava um único perfil, e é isso que impede o site e o app de fazerem duas ofertas diferentes.

Posso criar campanhas pela API ou só ler?

Os dois. Campanhas, ações, públicos, metas, catálogos e grupos de páginas podem ser criados e alterados, não só listados. Mudanças de conteúdo passam pelo mesmo versionamento do painel, então uma edição errada pode ser recuperada.

O que acontece se o serviço de vocês estiver lento ou fora do ar?

O timeout de uma chamada no servidor é você quem define. Estabeleça um limite com o qual se sinta confortável, volte ao seu conteúdo padrão quando ele for ultrapassado, e a página renderiza mesmo assim. Sua renderização nunca depende da decisão.

O MCP é um produto diferente da API?

Não — é a mesma conta atrás de um protocolo aberto. As ferramentas que um assistente vê correspondem aos mesmos objetos que a API REST expõe, com permissões que você concede e pode revogar separadamente da sua chave de API.

Regras de automação e relatórios agendados precisam de alguém logado?

É justamente essa a ideia. As regras são avaliadas no horário delas e os relatórios são enviados no deles, com ou sem alguém com o painel aberto.

Seu stack chama a Personyze.Ou ela chama seu stack.

Preço por volume, não o plano inicial.

Preço por volume para 240 licenças

O Marco Reyes parece pronto para comprar.

Chame de qualquer lugar. A mesma decisão.

Três versões de um endpoint.

Node, PHP e Python

iOS, Android, React Native

API JavaScript no cliente

Tudo o que o painel edita, em um só endpoint.

Tudo o que a tela de campanhas edita, pelo seu próprio código.

Segmentos que você monta, ou segmentos que você alimenta.

Um perfil, seja quem for que pergunte.

Seu catálogo, ordenado para uma pessoa.

O que conta, registrado onde acontece.

Os mesmos números que as telas mostram.

Regras, testes e relatórios que não precisam de você.

Se isto, então aquilo

Chega antes da reunião

Duas versões, uma vencedora

Ou deixe um assistente fazer as perguntas.

Pergunte sobre a conta

Peça o rascunho

Deixe-o agir com base no que encontrou

Duas formas de acesso, revogadas separadamente.

O que as pessoas perguntam antes de integrar.

Integre uma vez. Chame de qualquer lugar.

Seu stack chama a Personyze.
Ou ela chama seu stack.