@qomni/sdk envolve cada operação da referência em um
método com os tipos do contrato: qomni.agents.createCall,
qomni.agents.listCalls, qomni.agents.createRealtimeSession e o restante.
É gerado a partir do contrato, então um método sempre pede o que a
operação pede.
Antes de começar
- Bun, ou Node.js 22.18 ou superior (os dois executam TypeScript sem compilar).
- Uma chave de teste do Agents (
sk_agents_test_…) na variávelQOMNI_KEY, como no início rápido. - O pacote ainda não está no npm: instale-o a partir da pasta
sdks/typescript/do repositório do Qomni.
-
Instale o pacote
pnpm add ../qomni/sdks/typescript -
Crie o cliente e faça uma chamada
A chave decide o produto e o modo: uma chave do Agents serve em
qomni.agents. Salve o código emcall.mts.call.mtsts import { Qomni, QomniError } from "@qomni/sdk"; const qomni = new Qomni({ apiKey: process.env.QOMNI_KEY! }); try { const call = await qomni.agents.createCall( { to: "+15005550001" }, { idempotencyKey: "order-1001" }, ); console.log(call.id, call.status); } catch (error) { if (error instanceof QomniError) { console.error(error.status, error.code, error.message); } else { throw error; } } -
Execute
bun run call.mtsSem Bun?
Node.js 22.18 ou superior executa o mesmo arquivo sem alterações:
node call.mts
Você deve ver
call_01hv4k8s2m9q7w3e5r6t8y0u1i completedO SDK enviou POST https://api.qomni.ai/agents/v1/calls com sua chave em
Authorization, o corpo em JSON e Idempotency-Key: order-1001. Em modo
de teste nenhum telefone tocou: +15005550001 é um número mágico que
termina completed. Se a chave não for válida, a API responde 401 e o SDK
lança um QomniError com o code do erro, por exemplo
api_key_malformed.
Próximos passos
- Cada método tem o nome da sua operação na referência do Agents:
parâmetros de caminho, depois o corpo, depois a query, depois as opções
(
idempotencyKey,signal,headers). O exemplo em TypeScript de cada operação já usa o SDK. - Fale com um agente em tempo real:
createRealtimeSessionabre a conversa. - Erros: os códigos que um
QomniErrorpode trazer. - Idempotência: quando enviar
idempotencyKey.