Ir para o conteúdo
Ouviro
Tradução preliminar: esta página aguarda revisão por um falante nativo.

Consulta de planos e assentos: em breve

Em breve: respostas de IA sobre planos e assentos.

A consulta de pedidos somente para leitura já está disponível após configurar sua API. As consultas de transferências, faturas e planos com identidade da conta verificada pelo servidor chegarão em breve.

A consulta de assinaturas somente de leitura futura usará a identidade da conta verificada pelo servidor. Hoje, você pode usar respostas multilíngues com sua documentação e transferência para a equipe. As consultas de conta ainda não estão disponíveis; alterações ficam com pessoas autorizadas.

Começar o teste grátis

Dados de exemplo · fictícios

SaaS

Cliente

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

Ferramenta somente leitura · em breve
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ê os dados da 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, não convida colegas, não 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.

Cada cliente atendido no próprio idioma. Sua equipe assume quando necessário.

Conecte sua base de conhecimento: a IA responde no idioma do cliente e transfere para sua equipe quando necessário.

Começar o teste grátis