API e programadores
Os seus sistemas leem e escrevem dados no Kanesh.
API REST, servidor MCP e webhooks assinados, com chaves revogáveis e permissões limitadas. Para projetos aprovados, não em autosserviço.
Beta Disponível para projetos aprovados, não em autosserviço.
# Listar contactos com uma chave só de leituracurl https://app.kanesh.example/api/v1/contacts \ -H "Authorization: Bearer kn_live_••••"Chaves que só fazem o que autoriza.
API REST e esquema OpenAPI para os seus dados, com chaves de permissões limitadas. Dê a cada integração a sua chave, apenas com as permissões necessárias.
- Um esquema OpenAPI para gerar um cliente na linguagem que utiliza.
- Permissões de leitura, escrita ou envio, recurso a recurso.
- As chaves são guardadas como hash e podem ser revogadas a qualquer momento.
- Envios de modelos idempotentes: repetir uma tentativa não envia uma segunda mensagem ao cliente.
- Documentação de referência na aplicação depois da aprovação do projeto.
Ilustração da criação de uma chave API: recebe um nome e apenas as permissões necessárias, é mostrada uma vez e depois revogada. Os pedidos que a utilizam passam a ser rejeitados.
Os seus sistemas também precisam de falar com os clientes.
Dados isolados
Contactos, conversas e encomendas que o seu ERP ou BI não consegue ler.
Avisos que nunca saem
O seu sistema deteta um evento, mas não consegue enviar o modelo WhatsApp adequado.
Integrações frágeis
Scripts sem autenticação nem limites que falham assim que algo muda.
O que pode autorizar uma chave a fazer.
Cada chave recebe apenas as permissões selecionadas. Estes são os recursos disponíveis hoje.
Ler
- contacts
- conversations
- messages
- orders
- team
- labels
- usage
- analytics
- attribution
- automations
- campaigns
- clicks
- segments
Escrever
- contacts
- conversations
- labels
- segments
Enviar
- templates:send
Os identificadores exatos das permissões constam da documentação dos projetos aprovados.
Ligue as suas ferramentas de IA aos dados do Kanesh.
Um servidor MCP para que as suas ferramentas de IA possam ler e atuar sobre os dados do Kanesh com uma chave API de permissões limitadas.
- Liga-se por HTTP em streaming e autentica-se com uma chave API Bearer.
- Funciona com clientes MCP que permitem definir essa chave. Não é um conector de um clique para aplicações de IA de consumo.
Ler
- Contactos
- Conversas
- Mensagens
- Encomendas
- Campanhas
- Segmentos e membros
- Automações
- Métricas
- Atribuições
Agir
- Enviar um modelo WhatsApp
- Adicionar uma nota
- Atribuir uma conversa
- Gerir etiquetas
- Criar ou atualizar um contacto
Eventos a sair, mensagens a entrar.
Mais duas possibilidades para ligar o Kanesh aos seus sistemas.
Webhooks assinados
BetaWebhooks assinados para eventos importantes, para que o seu endpoint confirme que vêm do Kanesh. A lista de eventos é partilhada com os projetos aprovados.
Canal API personalizado
BetaTraga as conversas de um canal que gere para a caixa partilhada através da API.
Quatro passos, sem registo em autosserviço.
- 01
Descreva o projeto
O que pretende ligar e de que dados precisa.
- 02
Aprovamos o projeto
Se for adequado, ativamos o acesso à API no seu espaço de trabalho.
- 03
Chaves com permissões limitadas
Uma chave por integração, apenas com as permissões necessárias.
- 04
Desenvolva e revogue
Desenvolva com o esquema OpenAPI. Revogue uma chave quando quiser.
Perguntas dos programadores
Posso obter já uma chave API?
Existe um SDK?
Posso ligar o ChatGPT ou o Claude?
Que eventos cobrem os webhooks?
E se uma chave for exposta?
Diga-nos o que pretende criar.
O acesso é concedido por projeto. Explique no diagnóstico o que pretende ligar e diremos com franqueza se é adequado.