APIs e MCP: tokens, agentes de IA e webhooks
Viagilize
Tutoriais oficiais · Configurações
Obrigado pelo aviso. O que faltou ou ficou confuso? (opcional)
Recebemos. Vamos rever este vídeo.
6 visualizações · · 3:02
Neste vídeo você vai conhecer a tela APIs e MCP, onde você liga outros sistemas e assistentes de inteligência artificial ao Viagilize. No topo, Tokens Ativos e Webhooks Ativos contam o que está configurado Requisições (24h) e Taxa de Sucesso mostram o movimento do último dia.
Capítulos
Este vídeo responde
- Como conecto um assistente de inteligência artificial ao meu Viagilize?
- Onde crio um token de API para integrar com meu ERP ou CRM?
- Como configuro um webhook para receber notificações quando uma reserva for criada?
- Onde vejo o histórico de requisições e entregas de webhooks?
- Como baixo a documentação da API para entregar ao time técnico?
- Como ajusto a validade dos links de login gerados pela API?
- O que fazer quando o webhook está com muitas falhas consecutivas?
- Como revogar um token sem perder o histórico de uso?
- Onde está a chave de acesso que copiei quando criei o token?
- Como testar se o webhook está funcionando antes de colocar em produção?
#api #token #webhook #integracao #mcp #agentesia #logs #documentacao #openapi #hmac #magiclinks #configuracoes #bearer #scopes
Transcrição
-
Indicadores
No topo, Tokens Ativos e Webhooks Ativos contam o que está configurado Requisições (24h) e Taxa de Sucesso mostram o movimento do último dia. Na aba Agentes de IA você liga o ChatGPT, o Claude ou outro assistente: ele consulta viagens e monta reservas conversando.
-
Agentes de IA
Em Como conectar, use Copiar endereço e cole no seu assistente: ele abre o Viagilize para você autorizar.
-
Como conectar
Sem isso, use Gerar chave manual. Em Conexões ativas há uma linha por pessoa, com a etiqueta Somente consulta ou Consulta e opera.
-
Conexões ativas
Desconectar corta o acesso na hora.
-
Tokens de Acesso
A aba Tokens de Acesso guarda as chaves que outros sistemas usam na sua API, com a situação, o último uso e as Permissões de cada uma. Novo Token abre a janela onde você nomeia a chave, define a expiração e marca as permissões.
-
Novo Token
A chave aparece uma única vez: copie no ato.
-
Regenerar e revogar
Em cada token ficam Editar, Regenerar Token, Revogar e Excluir revogar corta o acesso sem apagar o histórico. Abaixo fica a URL Base.
-
Webhooks
Na aba Webhooks é o contrário: o Viagilize avisa o seu sistema quando algo acontece aqui. Em Novo Webhook você cadastra o endereço de destino.
-
Eventos e segredo
Eventos inscritos diz o que dispara o aviso, Secret para validação prova que a chamada saiu daqui, e o botão de testar dispara na hora. Dez falhas seguidas desativam o webhook.
-
Logs
A aba Logs tem duas listas: em Requisições você filtra por Token, Status, Método e Período em Webhooks vê cada aviso enviado. Na aba Documentação, Abrir Documentação leva ao portal com todos os recursos da API explicados, para quem vai programar a integração.
-
Documentação
Para uma inteligência artificial, crie um token enxuto e, nele, abra Documentação para IA e marque as operações. Isso é só documentação: o acesso quem controla são as permissões.
-
Documentação para IA
Em Downloads para Integrações você baixa a Postman Collection e o arquivo OpenAPI / Swagger para o time técnico. Na aba Configurações você define a validade dos Magic Links da API.
-
Downloads
Escolha o valor, a unidade e clique em Salvar configurações.
-
Configurações
Pronto. A tela fica em Configurações, depois APIs / MCP. Até a próxima.