Integração · Marketing

Conecte Claude e ChatGPT ao Roster

Pergunte à sua IA quais os ambassadores que geraram mais vendas, quem se inscreveu num programa ou quais prémios ainda estão pendentes no Roster. Ela pode pesquisar contactos, programas, campanhas, pedidos e códigos de desconto, além de extrair métricas de desempenho e relatórios de atribuição de vendas. Também pode criar contactos e códigos de desconto, adicionar ambassadores a um programa e definir o estado dos prémios.

Ligar Roster gratuitamente

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

Experimente pedir

“Quais ambassadores geraram mais receita no último mês?”
A IA executa o relatório de atribuição de vendas para esse intervalo de datas e lista a receita referida, cliques, novos clientes e pedidos por ambassador.
“Quem se inscreveu no nosso programa de verão e ainda está pendente?”
Ela encontra o programa e lista os candidatos com estado pendente. Pode abrir uma inscrição para mais detalhes.
“Crie o código MARIA15 para Maria sob a nossa regra de ambassador de 15%.”
Ela pesquisa as regras de desconto pela ID da regra, encontra o contacto de Maria e cria o código atribuído a ela.

O que a sua IA pode fazer

Ambassadores e contactos

Pesquisar, encontrar, criar e atualizar contactos, adicioná-los a programas como ambassadores e revisar candidatos a programas.

Vendas e desempenho

Listar pedidos, ver qual ambassador os referiu e obter métricas de desempenho para programas, campanhas e contactos.

Prémios e códigos de desconto

Listar prémios, prémios em dinheiro e prémios por referência, definir o estado de cumprimento e criar ou consultar códigos de desconto.

“Quem é dono do código de desconto SUMMER20?”
Ela consulta o código e mostra a qual ambassador pertence e qual regra de desconto utiliza.
“Marque estes prémios como cumpridos e avise os ambassadores.”
Ela define o estado dos prémios como cumprido com notificação ativada, para que o Roster envie emails aos ambassadores.
“Como está a nossa campanha de primavera?”
Ela pesquisa campanhas por nome, obtém as métricas de desempenho da campanha e lista os seus participantes.

105 ferramentas para Roster

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_program_ambassadorsAltera dadosAdicionar um ou mais contatos (`contact_ids`) como embaixadores a um programa por `program_id`. Pode enviá-los por e-mail, a menos que `suppress_email` seja verdadeiro.
approve_cash_rewardVisível para outras pessoasAprovar uma recompensa em dinheiro. Tem efeitos visíveis fora deste sistema. Resumo da API: Aprova recompensas em dinheiro pendentes. A aprovação não paga - o pagamento ocorre em lote.
approve_referral_rewardVisível para outras pessoasAprovar uma recompensa de referência. Tem efeitos visíveis fora deste sistema. Resumo da API: Aprova recompensas de referência pendentes.
archive_discount_codeVisível para outras pessoasDesativar um código de desconto (id do código de desconto). Tem efeitos visíveis fora deste sistema. Resumo da API: Desativa o código de desconto de um ambassador.
archive_discount_ruleVisível para outras pessoasArquivar uma regra de desconto (id da regra de desconto). Tem efeitos visíveis fora deste sistema. Resumo da API: Arquiva uma regra de desconto expirada. Desativa todos os códigos e agenda limpeza do Shopify se aplicável.
create_assignedAltera dadosCriar um novo atribuído. Obrigatório: códigos. Resumo da API: Importa um lote de códigos de desconto atribuídos em uma regra de desconto.
create_cash_rewardAltera dadosCriar uma nova recompensa em dinheiro. Resumo da API: Cria uma recompensa manual em dinheiro - dinheiro devido por trabalho sem campanha ou marco atrás.
create_channelAltera dadosCriar um novo canal. Pesquise canais primeiro para evitar duplicatas. Resumo da API: Cria um canal.
create_clickAltera dadosCriar um novo clique. Resumo da API: Cria um clique de link.
create_contactAltera dadosCriar um contato com `email` e `first_name`, além do sobrenome, telefone, data de nascimento, manuseios sociais e tags (separados por vírgula) opcionais.
create_contact_propertyAltera dadosCriar uma nova propriedade para um contato. Obrigatório: valor da propriedade ou id da propriedade. Resumo da API: Define uma propriedade para um contato.
create_discount_codeAltera dadosCriar um desconto `code` sob uma regra de desconto (`discount_rule_id`) e atribuí-lo a um ambassador (`ambassador_id`).
create_likeAltera dadosCriar um novo like. Resumo da API: Cria um like para um post ou comentário.
create_messageAltera dadosCriar uma nova mensagem. Resumo da API: Cria um comentário para um post ou comentário.
create_orderAltera dadosCriar um novo pedido. Obrigatório: ID externo do pedido, data do pedido, moeda ou preço total. Resumo da API: Cria um pedido.
create_pageAltera dadosCriar uma nova página. Obrigatório: ID do canal, status ou ID de usuário. Pesquise as páginas primeiro para evitar duplicatas. Resumo da API: Cria um post.
create_program_applicantAltera dadosCriar um novo candidato para um programa. Obrigatório: e-mail. Resumo da API: Adicionar um novo candidato a um programa.
create_referral_rewardAltera dadosCriar uma nova recompensa de indicação. Obrigatório: detalhes do pedido ou ID de embaixador. Resumo da API: Cria uma recompensa manual de indicação pendente.
create_unassignedAltera dadosCriar um novo não atribuído. Obrigatório: códigos. Resumo da API: Importa um lote de códigos de desconto não atribuídos para uma regra de desconto.
create_undoAltera dadosCriar um novo desfeito. Resumo da API: Define recompensas em dinheiro aprovadas ou rejeitadas como pendentes.
create_undo_postAltera dadosCriar um novo desfeito. Resumo da API: Define recompensas de indicação aprovadas ou rejeitadas como pendentes.
create_webhookElimina dadosCriar um novo webhook. Ação destrutiva; pode exigir aprovação. Resumo da API: Cria um novo webhook.
delete_channel_participantsMovimenta dinheiroExcluir permanentemente um participante por ID do canal. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Remove participantes de um canal.
delete_contactElimina dadosExcluir permanentemente um contato por ID de contato. Ação destrutiva; pode exigir aprovação. Resumo da API: Exclui um único contato.
delete_contact_propertyElimina dadosExcluir permanentemente uma propriedade por ID de propriedade. Ação destrutiva; pode exigir aprovação. Resumo da API: Exclui uma propriedade de um contato.
delete_discount_ruleElimina dadosExcluir permanentemente uma regra de desconto por ID de regra de desconto. Ação destrutiva; pode exigir aprovação. Resumo da API: Exclui uma regra de desconto que não tem códigos atribuídos ou não está vinculada a outro objeto.
delete_discount_rule_unassignedsMovimenta dinheiroExcluir permanentemente um não atribuído por ID de regra de desconto. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Exclui códigos de desconto não atribuídos em uma regra de desconto.
delete_likeElimina dadosExcluir permanentemente um like por ID de like. Ação destrutiva; pode exigir aprovação. Resumo da API: Exclui um like de um post ou comentário.
delete_pageElimina dadosExcluir permanentemente uma página por ID de página. Ação destrutiva; pode exigir aprovação. Resumo da API: Exclui um post e todos os registros filhos.
delete_program_ambassadorsMovimenta dinheiroExcluir permanentemente um embaixador por ID do programa. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Remove um embaixador de um programa.
delete_reward_templateElimina dadosExcluir permanentemente uma template de recompensa pelo seu ID. Ação destrutiva; pode exigir aprovação. Resumo da API: Exclui uma template de recompensa.
delete_webhookElimina dadosExcluir permanentemente um webhook pelo seu ID. Ação destrutiva; pode exigir aprovação. Resumo da API: Exclui um webhook existente.
find_contactsEncontrar contatos por `email` exato, `instagram_handle`, `referral_link_id` ou uma lista de `contact_ids`.
get_accountObter detalhes da conta Roster conectada. Use para confirmar em qual conta está trabalhando.
get_attributionObter uma atribuição pelo seu ID. Resumo da API: Recupera uma única atribuição.
get_campaign_performanceObter indicadores de desempenho para uma campanha pelo `campaign_id`.
get_channelObter um canal pelo seu ID. Resumo da API: Recupera um canal específico.
get_contactObter um contato pelo `contact_id`, com perfil, tags e handles sociais.
get_contact_performanceObter indicadores de desempenho para um único contato via `contact_id`, como referências e vendas.
get_contact_propertyObter uma propriedade para um contato pelo seu ID. Resumo da API: Recupera uma propriedade específica de um contato.
get_discount_codeObter um código de desconto pelo seu ID. Resumo da API: Recupera um código de desconto específico.
get_discount_ruleObter uma regra de desconto pelo seu ID. Resumo da API: Recupera uma regra de desconto específica.
get_eventObter um evento pelo seu ID. Resumo da API: Recupera um evento específico.
get_import_statusObter o status atual de uma importação. Resumo da API: Verifica se a marca tem uma tarefa ativa de importação de contatos.
get_messageObter uma mensagem pelo seu ID. Resumo da API: Recupera um comentário específico.
get_orderObter um pedido pelo Roster `order_id`, com totais, itens e atribuição.
get_pageObter uma página pelo seu ID. Resumo da API: Recupera um post específico.
get_programObter um programa de embaixador pelo `program_id`.
get_program_applicantObter um candidato a programa pelo `program_id` e `applicant_id` (ID do contato), incluindo sua aplicação.
get_program_performanceObter métricas de desempenho do dashboard para um programa por `program_id` em um intervalo de datas (padrão os últimos 30 dias).
get_referral_rewardObter uma recompensa de referência pelo `referral_reward_id`.
get_rewardObter uma recompensa pelo `reward_id`.
get_reward_templateObter uma template de recompensa pelo seu ID. Resumo da API: Recupera uma template de recompensa específica.
get_sales_attribution_reportRelatar receita referenciada, cliques, novos clientes e pedidos por embaixador em um intervalo de datas, filtrável por programa ou tag.
get_webhookObter um webhook pelo seu ID. Resumo da API: Recupera um webhook específico.
list_application_formsListar formulários de aplicação. Resumo da API: Recupera a definição do formulário de aplicação para um programa.
list_attributionsListar atribuições. Filtros opcionais: IDs de embaixador, IDs de programa, IDs de tag, ID de pedido, número externo de pedido ou tipo de atribuição. Resultados são paginados. Resumo da API: Recupera uma lista de todas as atribuições.
list_campaign_participantsListar os participantes de um campanha pelo `campaign_id`, filtrado pela participação `status`.
list_campaign_rewardsListar recompensas para uma campanha. Filtros opcionais: embaixador, tipo, status, status de caixa, emissão de recompensa da campanha ou IDs de recompensa. Resultados são paginados. Resumo da API: Recupera uma lista de todas as recompensas da campanha.
list_cash_rewardsListar recompensas em dinheiro, filtradas por ambassador, origem, status ou data de ganho.
list_channel_participantsListar participantes para um canal. Filtros opcionais: IDs de contato, IDs de programa, campo de ordenação ou direção de ordenação. Os resultados são paginados. Resumo da API: Recupera uma lista dos participantes de um canal.
list_clicksListar cliques. Filtros opcionais: ID do ambassador, ID do link de referência, data de criação mínima ou máxima. Os resultados são paginados. Resumo da API: Recupera uma lista de todos os cliques.
list_contact_propertiesListar propriedades para um contato. Os resultados são paginados. Resumo da API: Recupera uma lista das propriedades de um contato.
list_eventsListar eventos. Filtros opcionais: tipo de assunto, verbo, ID do assunto, ID desde, data de criação mínima ou máxima. Os resultados são paginados. Resumo da API: Recupera uma lista de todos os eventos.
list_likesListar curtidas. Filtros opcionais: ID pai, tipo de pai, ID do usuário, campo de ordenação ou direção de ordenação. Os resultados são paginados. Resumo da API: Recupera uma lista de todas as curtidas.
list_mesListar mensagens (mes). Resumo da API: Recupera um perfil.
list_messagesListar mensagens. Filtros opcionais: ID pai, tipo de pai, ID do usuário, campo de ordenação ou direção de ordenação. Os resultados são paginados. Resumo da API: Recupera uma lista de comentários.
list_milestone_series_participantsListar participantes para uma série de marcos. Filtros opcionais: IDs de ambassadores, IDs de programas, IDs de marco atual, campo de ordenação ou direção de ordenação. Os resultados são paginados. Resumo da API: Recupera uma lista dos participantes de uma série de marcos.
list_milestone_series_rewardsListar recompensas para uma série de marcos. Filtros opcionais: ambassador, marco, programa, status, status em dinheiro ou tipo. Os resultados são paginados. Resumo da API: Recupera uma lista de recompensas de marcos.
list_ordersListar pedidos, filtrados por cliente, e-mail do cliente, código de desconto ou intervalo de datas. Use para ver vendas referenciadas.
list_pagesListar páginas. Filtros opcionais: IDs de ambassadores, IDs de programas, IDs de campanha, IDs de tag, redes ou data inicial. Os resultados são paginados. Resumo da API: Recupera o relatório Social Posts: totais gerais mais uma linha por ambassador que postou no intervalo de datas (contagem de posts e stories, alcance, impressões...).
list_pages_getListar páginas. Filtros opcionais: redes, IDs de programas, ID do contato, data inicial, data final ou ordenação. Os resultados são paginados. Resumo da API: Posts individuais recentes onde os ambassadores mencionaram a marca — o feed social do portal: URL do post e mídia, legenda, plataforma, tipo de post...
list_program_ambassadorsListar os embaixadores de um programa por `program_id`, opcionalmente filtrado por IDs de contato ou data de adição.
list_program_applicantsListar candidatos a um programa por `program_id`, filtrado por `status` (pendente, nomeado, aprovado, rejeitado, removido).
list_programsListar programas de embaixadores, opcionalmente filtrado por `status` (ativo, arquivado).
list_referral_rewardsListar recompensas de referência (comissão ou pontos), filtrado por programa, embaixador ou `reward_status` (pendente, aprovado, pago, rejeitado).
list_reward_template_rewardsListar recompensas para uma template de recompensa. Filtros opcionais: embaixador, status, status do dinheiro, criado a partir de min, criado até max ou campo de ordenação. Resultados são paginados. Resumo da API: Recupera a lista de recompensas para uma template de recompensa.
list_rewardsListar recompensas (produtos, códigos de desconto, pontos, comissão) filtrado por `type`, `source` ou cumprimento `status`.
list_sample_csvsListar amostras CSV. Resumo da API: Baixa uma template CSV de amostra para importações de contatos.
list_summariesListar resumos. Filtros opcionais: ID do embaixador, status da recompensa, fonte, ganho a partir de min ou ganho até max. Resumo da API: Recupera os totais de resumo apenas em dinheiro para o livro-razão. Nunca combinado com pontos.
list_webhooksListar webhooks. Filtros opcionais: endereço, tópico, criado a partir de min ou criado até max. Resultados são paginados. Resumo da API: Recupera uma lista de todos os webhooks.
lookup_discount_codeConsultar um código de desconto pelo seu texto `code` para ver quem é o dono e suas regras.
pay_clickMovimenta dinheiroCapturar um clique. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Cria um clique usando um token de acesso público.
pay_orderMovimenta dinheiroCapturar um pedido. Ação financeira ou irreversível; pode exigir aprovação. Resumo da API: Cria um pedido usando um token de acesso público.
reject_cash_rewardVisível para outras pessoasRejeitar uma recompensa em dinheiro. Tem efeitos visíveis fora deste sistema. Resumo da API: Rejeita recompensas em dinheiro pendentes.
reject_referral_rewardVisível para outras pessoasRejeitar uma recompensa de referência. Tem efeitos visíveis fora deste sistema. Resumo da API: Rejeita recompensas de referência pendentes.
search_campaignsPesquisar campanhas por nome em `query`, filtrado por `status` ou `type`.
search_channelsPesquisar canais por programa, status, texto de pesquisa, criado a partir de min, criado até max ou campo de ordenação. Use isso para encontrar canais existentes antes de criar um novo canal. Resultados são paginados. Resumo da API: Recupera uma lista de canais.
search_contactsPesquisar contatos (ambassadors e clientes) por texto livre em `query` sobre nomes, emails e handles sociais, com ordenação opcional.
search_discount_rule_discount_codesPesquisar códigos de desconto para uma regra de desconto por consulta, ambassador, status, ids do código, campo de ordenação ou direção. Use isso para encontrar códigos existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Recupera uma lista de códigos de desconto para uma regra.
search_discount_rulesPesquisar regras de desconto por `query`, filtrado por `status` ou tipo. Use para encontrar o ID da regra antes de criar códigos.
search_pagesPesquisar páginas por ids do canal, status, ids do usuário, texto de pesquisa, filtro fixado ou campo de ordenação. Use isso para encontrar páginas existentes antes de criar uma nova. Os resultados são paginados. Resumo da API: Recupera uma lista de posts.
search_reward_templatesPesquisar modelos de recompensa por consulta, ids do ambassador, tipos de recompensa, opções de ação necessária, criado a partir de min ou max. Use isso para encontrar modelos existentes antes de criar um novo. Os resultados são paginados. Resumo da API: Recupera uma lista de modelos de recompensa.
set_reward_statusAltera dadosDefinir o status de cumprimento do `status` (cumprido, pendente, willNotFulfill, notRedeemed) para um ou mais `reward_ids`. Com `notify` verdadeiro e status cumprido, envia emails aos embaixadores.
update_cash_rewardAltera dadosAtualizar uma recompensa em dinheiro existente identificada pelo id de recompensa em dinheiro. Resumo da API: Edita uma recompensa manual enquanto ainda está Pendente. Uma rota separada do create POST porque os dois impõem precondições diferentes;….
update_channelAltera dadosAtualizar um canal existente identificado pelo id do canal. Resumo da API: Atualiza um canal.
update_channel_programsVisível para outras pessoasAtualizar um programa existente identificado pelo id do canal. Tem efeitos visíveis fora deste sistema.
update_contactVisível para outras pessoasAtualizar um contato por `contact_id`: nome, email, telefone, data de nascimento ou handles sociais, e adicionar ou remover tags. Apenas os campos que você passa mudam.
update_contact_propertyAltera dadosAtualizar uma propriedade existente identificada pelo id de propriedade. Resumo da API: Atualiza uma propriedade para um contato.
update_mesVisível para outras pessoasAtualizar um me existente. Tem efeitos visíveis fora deste sistema. Resumo da API: Atualiza um perfil.
update_orderAltera dadosAtualizar uma ordem existente identificada pelo id de ordem. Resumo da API: Atualiza uma ordem.
update_pageAltera dadosAtualizar uma página existente identificada pelo id de página. Resumo da API: Atualiza um post.
update_referral_rewardAltera dadosAtualizar uma recompensa de referência existente identificada pelo id de recompensa de referência. Resumo da API: Atualiza uma recompensa manual pendente.
update_webhookElimina dadosAtualizar um webhook existente identificado pelo id do webhook. Ação destrutiva; pode exigir aprovação. Resumo da API: Atualiza um webhook existente.
upload_contactAltera dadosImportar um contato. Resumo da API: Cria uma nova tarefa de importação de contatos.

Configure em três passos

1
Escolha a aplicação
Crie uma conta gratuita no PipMCP e escolha Roster na lista de aplicações.
2
Cole a sua chave
Cole um token de acesso privado. No Roster, abra Configurações → Integrações → Acesso à API e gere um token. Use um token privado (leitura/escrita), pois os tokens públicos só funcionam para alguns endpoints de rastreamento do lado do cliente.
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 Roster?

Ela pode pesquisar e ler contactos, programas, candidatos, ambassadores, campanhas, pedidos, prémios, prémios por referência, prémios em dinheiro, regras de desconto e códigos de desconto, além de extrair métricas de desempenho e relatórios de atribuição de vendas. Pode criar e atualizar contactos, adicionar ambassadores a programas, criar códigos de desconto e definir o estado dos prémios.

A IA vê as minhas credenciais do Roster?

Não. Suas credenciais do Roster estão criptografadas em repouso e nunca são exibidas à IA. Após salvar, não aparecem novamente, nem mesmo para você. A IA vê apenas os resultados das ferramentas que chama.

Posso controlar o que a IA é autorizada a fazer?

Sim. Você escolhe quais ferramentas estão ativadas, podendo começar com relatórios e consultas apenas. Adicionar ambassadores pode enviar e-mails, e cumprir recompensas com notificação por e-mail requer aprovação de ambos. 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 cartão de crédito. Planos pagos cobram por tarefa concluída. Você também precisa de sua própria conta do Roster.

Por que preciso de um token privado e não um público?

O Roster possui dois tipos de tokens. Tokens públicos funcionam apenas em alguns endpoints de rastreamento lado cliente, não podendo ler contatos, pedidos ou recompensas. Um token privado tem acesso de leitura e escrita, necessário pelas ferramentas que você ativa.