A Ada é um nome conhecido no serviço de apoio ao cliente com IA. Se utiliza a plataforma deles, provavelmente já ouviu falar da sua mais recente atualização: a API v2 da Ada. As atualizações de API podem ser uma faca de dois gumes. Por um lado, podem otimizar a forma como as suas ferramentas comunicam entre si. Por outro, podem significar muito trabalho para os seus developers e, potencialmente, complicar os seus fluxos de trabalho existentes.
Então, o que é que esta atualização significa realmente para si e para a sua equipa? Vamos analisar as principais alterações na API v2 da Ada, explicar o que é necessário para migrar e olhar para o panorama geral. Depender demasiado da API de uma única plataforma pode ser restritivo, e vamos explorar por que motivo uma abordagem mais flexível e focada na integração pode ser mais adequada para a sua estratégia de automação a longo prazo.
O que é a API v2 da Ada?
Simplificando, a API v2 da Ada é a próxima geração das interfaces de programação de aplicações da Ada. Foi concebida para criar uma forma mais padronizada e previsível para os developers criarem integrações e conectarem outras ferramentas à plataforma Ada.
De acordo com a própria documentação da Ada, os principais objetivos são organizar as coisas e melhorar a experiência para os developers. Estão a fazer isto através de:
-
Consolidação de endpoints: Fusão de endpoints de API mais antigos e desajeitados para reduzir a confusão.
-
Otimização de tokens de API: Transição para um único token para autenticação, em vez de obrigar os developers a gerir várias chaves.
-
Padronização de respostas: Garantir que todas as chamadas de API devolvem dados num formato consistente.
-
Melhorias técnicas: Clarificar aspetos como a paginação e os limites de taxa para os tornar mais fiáveis.
Pode pensar nisto como o amadurecimento de uma plataforma. À medida que as ferramentas crescem, precisam frequentemente de reconstruir as suas bases para lidar com exigências mais complexas e de nível empresarial. Esta atualização é o passo da Ada na construção de uma estrutura mais robusta e escalável para os developers.
Principais alterações e melhorias na API v2 da Ada
A atualização v2 traz várias melhorias técnicas que os developers provavelmente irão apreciar. Mas sejamos realistas, estas alterações também significam que terá de atualizar quaisquer integrações existentes que tenha construído.
Endpoints consolidados e tokens otimizados
Uma das maiores mudanças é o abandono de endpoints dispersos e fragmentados. Antes, podia ter vários endereços de API diferentes para um único recurso. Agora, estão a ser fundidos em estruturas mais lógicas e baseadas em recursos. Por exemplo, o que antes era /api/end-users/v1/ agora é apenas /api/v2/end-users/.
Na mesma linha, a Ada está a abandonar os tokens de API separados para cada API e, em vez disso, a usar um único token de plataforma partilhado. Isto certamente simplifica a gestão da autenticação, uma vez que tem menos chaves para controlar. O senão? As suas chaves v1 antigas não funcionarão com os novos endpoints v2, pelo que terá de gerar novas e substituí-las em todo o lado.
Estruturas de resposta uniformes e paginação padronizada
Se alguma vez construiu uma integração, sabe como é frustrante quando os dados são devolvidos em formatos diferentes. A API v2 da Ada resolve isto ao introduzir uma estrutura JSON uniforme para todas as respostas, incluindo erros. Esta é uma mudança bem-vinda que simplifica o código necessário para manipular e analisar os dados.
Também padronizaram a forma como se extraem grandes conjuntos de dados. Em vez de lidar com diferentes métodos de paginação para diferentes endpoints, a v2 usa uma abordagem consistente baseada em cursor em todo o lado. Isto torna muito mais fácil obter grandes relatórios ou listas de conversas sem ter de escrever lógica personalizada para cada um.
Limites de taxa e políticas de dados melhorados
Alguma vez teve uma integração a falhar de repente por ter atingido um limite de API não documentado? A atualização v2 tenta evitar isso, introduzindo políticas de limites de taxa e de dados mais transparentes. Para as empresas, isto significa que pode planear melhor a sua utilização e evitar estrangulamentos inesperados durante os períodos de maior movimento, o que deverá levar a automações mais fiáveis.
Eis um resumo rápido das principais diferenças entre as versões antiga e nova:
| Funcionalidade | API v1 da Ada | API v2 da Ada |
|---|---|---|
| Endpoints | Múltiplos endpoints fragmentados por recurso. | Endpoints consolidados e orientados a recursos. |
| Autenticação | Token de API separado necessário para cada API. | Token de API único e partilhado para todos os endpoints. |
| Respostas | Formatos de resposta e erro variados. | Estrutura JSON uniforme para todas as respostas. |
| Paginação | Métodos de paginação inconsistentes. | Paginação padronizada baseada em cursor. |
| Limitação de Taxa | Políticas menos transparentes. | Políticas mais claras para maior fiabilidade. |
Migrar da v1: O que a atualização significa para si
Ok, então o que é que tudo isto significa para si se já é cliente da Ada? Em suma, tem um projeto técnico em mãos. As migrações de API exigem um planeamento cuidadoso e, mais importante, o tempo dos seus developers.
O roadmap oficial de migração para a API v2 da Ada
A Ada definiu um processo de quatro passos para passar da v1 para a v2:
-
Rever a documentação da v2: A sua equipa precisará de mergulhar na nova documentação para mapear as suas antigas chamadas de API para os novos endpoints e parâmetros.
-
Atualizar a autenticação: Isto significa gerar novos tokens de plataforma partilhados e substituir os antigos.
-
Testar num ambiente de homologação: Antes de entrar em produção, vai querer testar exaustivamente as suas integrações atualizadas numa sandbox para detetar quaisquer erros.
-
Monitorizar e otimizar: Assim que fizer a transição, terá de ficar de olho nos seus registos e no desempenho para corrigir quaisquer erros inesperados.
Os custos ocultos das migrações e da dependência de fornecedor
Embora os passos pareçam simples, qualquer developer lhe dirá que as migrações raramente são tão simples como parecem. Consomem horas valiosas de engenharia que poderiam ser gastas noutros projetos, e há sempre o risco de algo falhar.
Esta situação também lança luz sobre um problema maior: a dependência de fornecedor (vendor lock-in). Quando investe tempo e recursos na construção de fluxos de trabalho personalizados em torno da API proprietária de uma única plataforma, torna-se dependente dessa plataforma. Torna-se muito mais difícil e caro mudar de ferramentas no futuro, seja o seu helpdesk ou outra parte da sua stack tecnológica. Fica efetivamente preso ao ecossistema, ao roadmap e aos preços deles.
É aqui que entra em jogo uma filosofia diferente. As plataformas de IA modernas como a eesel AI são construídas para se conectarem às suas ferramentas existentes, e não para o forçar a construir tudo à volta delas. Pode conectar-se a helpdesks como Zendesk, Freshdesk e Intercom com integrações de um clique, sem código, sem migrações de API e sem necessidade de tempo de developers. O objetivo é entrar em funcionamento em minutos, não em meses.
Preços da Ada: O que esperar
Quando está a pensar no custo total de uma plataforma, o preço é uma peça enorme do puzzle. Com a Ada, descobrir isso não é tão simples. A sua página de preços não lista quaisquer preços reais. Em vez disso, tem de preencher um formulário, fornecer o seu volume de contactos e aguardar por uma demonstração de vendas.
Esta abordagem tem algumas consequências para os potenciais clientes:
-
Sem estimativas de custo rápidas: Não pode simplesmente navegar no site deles para ver se os seus planos se enquadram no seu orçamento. Tem de falar primeiro com uma equipa de vendas.
-
Variáveis imprevisíveis: Como o preço está frequentemente ligado a métricas como o volume de contactos, a sua fatura pode variar muito de mês para mês, tornando difícil prever os seus gastos.
-
Falta de transparência: Preços não divulgados publicamente significam muitas vezes que o que paga pode ser diferente do que outra empresa paga, e é menos provável que encontre planos flexíveis, de mês a mês.
Esta é outra área onde uma abordagem mais moderna pode ser uma lufada de ar fresco. Na eesel AI, acreditamos em preços transparentes e previsíveis. Todos os nossos planos estão listados publicamente na nossa página de preços, com níveis claros baseados no número de interações de IA de que necessita. Não há taxas por resolução, pelo que nunca terá uma fatura surpresa após um mês movimentado. Além disso, pode começar com um plano mensal e cancelar a qualquer momento, o que lhe dá o tipo de flexibilidade que os fornecedores maiores muitas vezes não oferecem.
Uma captura de ecrã da página de preços da eesel AI, mostrando níveis claros e transparentes, o que é um diferenciador chave em relação ao modelo de preços não divulgados publicamente discutido no contexto da atualização da API v2 da Ada.Um caminho mais simples para a automação do suporte com a eesel AI
Se procura uma IA potente e personalizável sem o grande esforço de engenharia ou a dependência da plataforma, vale a pena considerar uma alternativa construída para as equipas dinâmicas de hoje. A eesel AI foi concebida de raiz para ser simples, flexível e completamente self-service.
Eis o que a distingue:
-
Verdadeiramente self-service: Pode inscrever-se, conectar as suas ferramentas e lançar um agente de IA totalmente funcional por conta própria, sem nunca ter de falar com um vendedor. Diga adeus a demonstrações obrigatórias e a longas chamadas de onboarding.
-
Integra-se com as suas ferramentas existentes: A eesel AI não lhe pede para reformular a sua configuração atual. Conecta-se diretamente às ferramentas que já utiliza, incluindo o seu helpdesk, bases de conhecimento como o Confluence e o Google Docs, e plataformas de chat internas como o Slack.
Uma visão da plataforma eesel AI a destacar as suas integrações de um clique com vários helpdesks e bases de conhecimento, oferecendo uma alternativa mais simples a projetos complexos como a migração da API v2 da Ada.- Controlo total sem código: Não precisa de ser um developer para personalizar a sua IA. Com um editor de prompts simples e um motor de fluxos de trabalho, pode definir o tom de voz, a personalidade e as ações exatas que a sua IA pode realizar, desde escalar um ticket até procurar informações de encomendas no Shopify.
A interface de personalização na eesel AI onde os utilizadores podem definir regras e barreiras de proteção sem código, em contraste com o trabalho intensivo de desenvolvimento necessário para a API v2 da Ada.A conclusão sobre a API v2 da Ada
A API v2 da Ada é um passo lógico e necessário para a sua plataforma, trazendo uma padronização muito necessária para os developers. No entanto, também serve como um bom lembrete da complexidade, dependência de developers e risco de dependência de fornecedor que podem advir das suites de automação tradicionais e completas. O processo de migração em si é um exemplo perfeito dos recursos de engenharia necessários para manter integrações personalizadas numa plataforma proprietária.
Para equipas que valorizam a velocidade, flexibilidade e controlo, uma abordagem moderna e focada na integração oferece um caminho mais simples. Ao escolher uma solução que funciona com as suas ferramentas existentes, em vez de o forçar a construir em torno delas, pode obter uma automação potente sem o trabalho pesado.
Preparado para uma solução de suporte com IA que trabalha com as suas ferramentas, e não contra elas? Experimente a eesel AI gratuitamente e veja como pode configurar um agente de IA potente em minutos, não em meses.
Perguntas frequentes
A Ada introduziu a API v2 para criar uma forma mais padronizada e previsível para os developers construírem integrações. Os principais objetivos são consolidar endpoints, otimizar tokens de API, padronizar respostas e melhorar aspetos técnicos como a paginação e os limites de taxa.
Migrar para a API v2 da Ada envolve um projeto técnico significativo para a sua equipa. Requer a revisão da nova documentação, a atualização dos tokens de autenticação, testes exaustivos em ambientes de homologação e monitorização contínua.
A API v2 da Ada passa a usar um único token de plataforma partilhado para autenticação, substituindo os tokens de API separados necessários para cada API na v1. Isto simplifica a gestão, mas significa que tem de gerar novos tokens.
As suas chaves de API v1 antigas não funcionarão com os novos endpoints da API v2 da Ada. As integrações existentes construídas sobre a v1 exigirão atualizações e testes para funcionarem corretamente com a v2, o que significa que a migração é necessária.
As principais melhorias técnicas incluem endpoints consolidados e orientados a recursos, uma estrutura JSON uniforme para todas as respostas, paginação padronizada baseada em cursor e políticas de limites de taxa e de dados mais claras para uma maior fiabilidade.
Depender fortemente de uma API proprietária como a API v2 da Ada pode levar à dependência de fornecedor (vendor lock-in). Isto torna mais difícil e caro mudar de ferramentas no futuro e vincula a sua estratégia de automação ao ecossistema e roadmap dessa plataforma.
