Pular para o conteúdo
Qomni

Agents

Crie um agente, dê voz a ele e coloque-o para atender: REST para as ligações e um WebSocket para falar com ele em tempo real a partir do seu app.

URL base
https://api.qomni.ai/agents/v1
Chave
sk_agents_test_…
curl https://api.qomni.ai/agents/v1/calls \
  -H "Authorization: Bearer sk_agents_test_…"

Novidades

Navegação

Ask the demo to call

The website's "Llámame": the demo agent calls the visitor's phone from Qomni's demo number, in test mode, for at most max_duration_seconds. No key: Cloudflare Turnstile proves a person asked (turnstile_token), and the limits are the demo session's per IP plus one call per number a day and the same daily budget. Only numbers of Colombia, Mexico, Brazil and the US/Canada (+57, +52, +55, +1).

POST
https://api.qomni.ai/agents/v1/demo_calls

Corpo da requisiçãoJSONObrigatório

  • phonestringObrigatório

    The number to call, E.164.

    pattern: ^\+(57|52|55|1)[0-9]{7,12}$
  • turnstile_tokenstringObrigatório

    The token Cloudflare Turnstile gave the website's form.

    maxLength: 2048
  • nameOpcionalstring

    How the agent greets the person; optional.

    maxLength: 80
  • languageOpcionalesorenorpt-br
    default: "en"
  • agentOpcionalreceptionorschedulingorqualificationorsupportorcollectionsorreminders

    Which demo agent answers - a receptionist, appointment booking, lead qualification, first-level support, collections or appointment reminders.

    default: "reception"

Retorna

202

The call is being placed; the phone rings within seconds.

JSON
  • callstringObrigatório
    pattern: ^call_[0-9a-z]+$
  • max_duration_secondsintegerObrigatório

403

Turnstile did not confirm a person (captcha_failed), or the request came from another site (origin_not_allowed).
JSON
  • errorobjectObrigatório
    • codestringObrigatório

      Stable, machine-readable; each operation lists the codes it can return.

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObrigatório

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

422

The request does not match the contract (validation_failed).
JSON
  • errorobjectObrigatório
    • codestringObrigatório

      Stable, machine-readable; each operation lists the codes it can return.

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObrigatório

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

429

This address or this number has used the demo (rate_limited); retry after Retry-After seconds.
JSON
  • errorobjectObrigatório
    • codestringObrigatório

      Stable, machine-readable; each operation lists the codes it can return.

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObrigatório

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

503

The demo has used today's minutes, or places no calls in this environment (demo_unavailable).
JSON
  • errorobjectObrigatório
    • codestringObrigatório

      Stable, machine-readable; each operation lists the codes it can return.

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObrigatório

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

Novo

2 de 7 passos feitosA seguir: a plataforma em produção

A Qomni está em beta privada

A API e o app ainda não estão abertos. Veja o que está feito, o que falta e como abre, passo a passo até o primeiro cliente.

Digite para buscar…

↑↓ mover↵ abrirEsc para fechar