Ir para o conteúdo
Ouviro
Tradução preliminar: esta página aguarda revisão por uma pessoa nativa do idioma.

Para equipes de suporte SaaS

Uma dúvida sobre o plano. Uma resposta do seu sistema.

Conecte sua API de assinaturas somente de leitura para o cliente consultar o plano e os assentos disponíveis na conversa. Seu sistema fornece os dados; alterações ficam com pessoas autorizadas.

Começar teste grátis

Dados de exemplo · fictícios

SaaS

Cliente

Which plan are we on, and can we add one more seat?

Ferramenta somente de leitura
get_subscription() → plan: "Team Demo", seats_used: "4/5", extra_seat: "1 available"

Resposta da IA

You are on Team Demo with 4 of 5 seats in use. One seat is available. Your administrator can add a teammate; this lookup does not change your subscription.

A consulta apenas lê a assinatura. Alterações ficam com sua equipe ou com o administrador do cliente.

Consulta de assinatura vinculada à sessão

Nome da ferramenta
get_subscription
Descrição

Leia o plano, os assentos usados e os assentos extras disponíveis da conta autenticada.

URL do endpoint
GET https://api.example.com/accounts/{account_id}/subscription
Autenticação
Authorization: Bearer {{SUBSCRIPTION_API_SECRET}}
Mapeamento de entrada
account_id ← server.session.account_id
customer_id ← server.session.customer_id
Mapeamento de saída
plan ← $.subscription.plan
seats_used ← $.subscription.seats_used
extra_seat ← $.subscription.extra_seat

Configuração de exemplo para sua API de assinaturas somente de leitura. Substitua o endpoint e os campos; não representa um conector nativo de cobrança.

A identidade da conta e do cliente vem de server.session, não do chat. Seu endpoint deve verificar o vínculo com a conta e a permissão antes de retornar os campos da assinatura.

Leia o plano e os assentos na fonte

Configure get_subscription para retornar plan, seats_used e extra_seat da sua API de assinaturas. Explique os valores atuais sem presumir direitos de uso ou disponibilidade.

Restrinja a consulta à conta autenticada

O servidor fornece a identidade da conta e do cliente a partir da sessão autenticada. Seu endpoint deve verificar o vínculo com a conta e a permissão antes de retornar a assinatura.

Retorne apenas o que a resposta precisa

Mapeie os campos de plano e assentos necessários para a conversa. Mantenha as credenciais no servidor e exclua dados de pagamento, informações privadas de membros e dados de outras contas.

Deixe alterações com uma pessoa autorizada

A consulta não adiciona assentos, convida colegas, altera planos nem cancela assinaturas. Explique o próximo passo e encaminhe pedidos de alteração à sua equipe ou ao administrador do cliente.

Dúvidas antes de conectar

O que precisamos para conectar os dados da assinatura?

Uma API somente de leitura sob seu controle, credenciais no servidor e mapeamento dos campos de plano e assentos. Configure o endpoint e as verificações de acesso; é um exemplo de configuração, não um conector nativo de cobrança.

Um cliente pode consultar outra conta?

Uma mensagem não comprova acesso à conta. O servidor usa a identidade da sessão autenticada, e seu endpoint deve verificar o vínculo e a permissão para a conta consultada.

O assistente pode adicionar um assento ou mudar o plano?

Não. A primeira versão apenas lê os dados da assinatura. Um administrador autorizado ou sua equipe deve fazer alterações pelo fluxo de conta existente.

A conversa Team Demo mostra dados reais?

Não. O plano, a quantidade de assentos e as respostas são exemplos fictícios. Respostas reais dependem da API conectada e das permissões do cliente atual.

O cliente pergunta. A IA consulta seu sistema.

Conecte sua base de conhecimento e APIs somente de leitura para consultar pedidos, transferências, faturas e planos no idioma do cliente.

Começar teste grátis