Integração · Marketing

Conecte Claude e ChatGPT ao Leal

Pergunte à sua IA quantos selos um cliente tem, ou peça-lhe para adicionar selos e resgatar uma recompensa no Leal. Ela pode pesquisar e criar clientes, inscrevê-los em um cartão de fidelidade e criar ou alterar cartões e recompensas de fidelidade. Também pode listar as suas lojas e pôsteres de inscrição.

Ligar Leal gratuitamente

Plano gratuito, sem cartão de crédito. Demora cerca de um minuto.

Experimente pedir

“Quantos selos a Anna Berg tem no seu cartão de café?”
A IA pesquisa o cliente, lista os cartões de fidelidade que ela possui e lê o número atual de selos.
“Adicione 2 selos ao cartão de almoço do cliente 8812.”
Ela adiciona os selos ao cartão daquele cliente. O cliente pode receber uma notificação, a menos que peça para pular.
“Anna quer o seu café grátis. Resgate-o.”
Ela encontra a recompensa no seu cartão e resgata-a, utilizando os selos necessários.

O que a sua IA pode fazer

Clientes e selos

Pesquisar, criar e atualizar clientes, inscrevê-los em um cartão, adicionar selos e ler a contagem de selos em cada cartão que eles possuem.

Cartões de fidelidade e recompensas

Criar e atualizar cartões e recompensas de fidelidade, e resgatar uma recompensa no cartão de um cliente.

Lojas e locais

Ler os detalhes da sua loja, listar e criar locais, e listar pôsteres de inscrição por cartão ou status.

“Inscreva Jonas Holm ([email protected]) no nosso cartão de café e envie-lhe o link do cartão.”
Ela pesquisa primeiro para evitar duplicados, cria o cliente, inscreve-o no cartão e envia o link.
“Crie uma recompensa no cartão de almoço: sobremesa grátis após 8 selos.”
Ela cria a recompensa naquele cartão com nome, descrição e número de selos necessários.
“Quais são as recompensas ativas em cada um dos nossos cartões de fidelidade?”
Ela lista os seus cartões de fidelidade e as recompensas ativas em cada um, com o número de selos que cada uma precisa.

30 ferramentas para Leal

Estas ferramentas são ativadas quando estabelece a ligação. Pode desativar qualquer uma delas ou exigir a sua aprovação antes de ser executada.

add_stampsAltera dadosAdicionar um número de `stamps` ao cartão de fidelidade do cliente (`customer_id`, `customer_card_id`). O cliente pode ser notificado a menos que `skip_notifications` seja definido.
create_account_posterAltera dadosCriar um novo pôster para uma conta. Obrigatório: pôster. Resumo da API: Criar um pôster.
create_customerAltera dadosCriar um cliente com primeiro/último nome, email, telefone e aniversário, opcionalmente inscrevendo-os em um cartão de fidelidade (`card_id`). Com `send_card_links` o cliente recebe um link para o seu cartão. Pesquise primeiro para evitar duplicatas.
create_locationAltera dadosCriar um local da loja com nome e endereço.
create_loyalty_cardAltera dadosCriar um cartão de fidelidade com nome, número de selos necessários, selos iniciais, cores e texto do cabeçalho.
create_rewardAltera dadosCriar uma recompensa em um cartão de fidelidade com nome, descrição e número de selos necessários.
delete_account_addressElimina dadosApagar permanentemente um endereço pelo ID do endereço. Ação destrutiva; pode exigir aprovação. Resumo da API: Apagar uma localização.
delete_account_posterElimina dadosExcluir permanentemente um pôster pelo id do pôster. Ação destrutiva; pode exigir aprovação.
delete_account_rewardElimina dadosExcluir permanentemente uma recompensa pelo id da recompensa. Ação destrutiva; pode exigir aprovação.
get_account_addressObter um endereço para uma conta por id de endereço. Resumo da API: Mostrar um local.
get_account_posterObter um pôster para uma conta por id do pôster. Resumo da API: Mostrar um pôster.
get_customerObter um cliente por `customer_id`, com nome, email, telefone e aniversário.
get_customer_cardObter um dos cartões de fidelidade de um cliente por `customer_id` e `customer_card_id`, incluindo selos atuais.
get_loyalty_cardObter um cartão de fidelidade por `card_id`, incluindo design, selos necessários e validade.
get_rewardObter uma recompensa por `reward_id`, com seu nome, descrição e selos necessários.
get_storeObter os detalhes da loja Leal conectada, como seu nome.
list_accountsListar contas. Resumo da API: Listar todas as lojas.
list_customer_cardsListar os cartões de fidelidade que um cliente possui, com seus contagens de selos. Requer `customer_id`.
list_locationsListar os locais da loja (nome e endereço).
list_loyalty_cardsListar os cartões de fidelidade da loja. Use para encontrar um ID de cartão antes de adicionar clientes, selos ou recompensas.
list_postersListar os cartazes de inscrição da loja, opcionalmente filtrados por `card_id` ou status ativo.
list_rewardsListar as recompensas da loja, opcionalmente filtradas por `card_id` ou status ativo.
redeem_rewardAltera dadosResgatar uma recompensa (`reward_id`) no cartão de fidelidade do cliente (`customer_id`, `customer_card_id`), usando os selos que ela custa.
search_customersPesquisar clientes da loja por nome, e-mail ou telefone (`search`), origem ou ID externo. Use para encontrar um cliente antes de criar um.
update_accountAltera dadosAtualizar uma conta existente identificada pelo account id. Apenas os campos que você passa são alterados. Resumo da API: Atualizar uma loja.
update_account_addressAltera dadosAtualizar um endereço existente identificado pelo address id. Apenas os campos que você passa são alterados. Resumo da API: Atualizar um local.
update_account_posterAltera dadosAtualizar um cartaz existente identificado pelo poster id. Apenas os campos que você passa são alterados. Resumo da API: Atualizar um cartaz.
update_customerAltera dadosAtualizar o nome, e-mail, telefone, aniversário ou metadados de um cliente por `customer_id`. Apenas os campos que você passa mudam.
update_loyalty_cardAltera dadosAtualizar o nome, selos necessários, cores ou outros configurações de um cartão de fidelidade por `card_id`. Apenas os campos que você passa mudam.
update_rewardAltera dadosAtualizar o nome, descrição, selos necessários ou status ativo de uma recompensa por `reward_id`. Apenas os campos que você passa mudam.

Configure em três passos

1
Escolha a aplicação
Crie uma conta gratuita no PipMCP e escolha Leal na lista de aplicações.
2
Cole a sua chave
Cole um token da API do Leal e o ID da sua conta (loja). Faça login no Leal, abra tokens da API nas definições da sua conta (app.getleal.com/api_tokens), crie um token e copie-o. O token tem o mesmo acesso que o utilizador que o criou. O ID da sua conta (loja) é retornado pela chamada de API list accounts do Leal.
3
Adicione a ligação à sua IA
Receberá uma ligação MCP pessoal. Adicione-a ao Claude, ao ChatGPT ou ao Cursor:
1. Clique no seu nome e depois em Definições › Conectores › Adicionar conector personalizado.
2. Cole a sua ligação no campo URL do servidor MCP remoto.
3. Ative-o no menu + de uma conversa.

Perguntas

O que a IA pode fazer no Leal?

A IA pode ler a sua loja, locais, cartões de fidelidade, recompensas, pôsteres de inscrição, clientes e os cartões que cada cliente possui. Ela pode criar clientes, cartões de fidelidade, recompensas e locais, atualizar clientes, cartões e recompensas, adicionar selos e resgatar recompensas.

A IA vê o meu token da API do Leal?

Não. O seu token da API do Leal é criptografado em repouso e nunca é mostrado à IA. Após guardar, não é mostrado novamente, nem mesmo a si. A IA só vê os resultados das ferramentas que chama.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas, para começar em modo de leitura apenas. Adicionar selos e resgatar recompensas alteram o que um cliente tem no seu cartão, e ambas podem exigir sua aprovação antes de rodar. Toda chamada de ferramenta é registrada.

Funciona com o ChatGPT?

Sim. No ChatGPT, vá em Configurações › Aplicações & Conectores › Avançado e ative o Modo Desenvolvedor, depois adicione seu link do PipMCP. O Modo Desenvolvedor requer um plano pago do ChatGPT: Plus, Pro, Business ou Enterprise. O mesmo link funciona também no Claude (Configurações › Conectores › Adicionar conector personalizado), Cursor e outros clientes MCP.

Qual é o custo?

O PipMCP tem um plano gratuito sem necessidade de cartão de crédito. Planos pagos cobram por tarefa concluída. Você também precisa de uma conta Leal própria.

Os clientes serão notificados quando a IA adicionar selos?

Eles podem ser. O Leal pode notificar um cliente quando selos são adicionados, a menos que as notificações sejam pular para aquela chamada. Peça à IA para pular as notificações se você não quer que o cliente saiba sobre isso. Ao criar um cliente, a IA também pode enviar-lhes um link para o seu cartão.