Saltar al contenido
Qomni

Agents

Crea un agente, dale voz y ponlo a atender: REST para las llamadas y un WebSocket para hablar con él en tiempo real desde tu app.

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

Novedades

Navegación

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

Cuerpo de la peticiónJSONObligatorio

  • phonestringObligatorio

    The number to call, E.164.

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

    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"

Devuelve

202

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

JSON
  • callstringObligatorio
    pattern: ^call_[0-9a-z]+$
  • max_duration_secondsintegerObligatorio

403

Turnstile did not confirm a person (captcha_failed), or the request came from another site (origin_not_allowed).
JSON
  • errorobjectObligatorio
    • codestringObligatorio

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

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObligatorio

      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
  • errorobjectObligatorio
    • codestringObligatorio

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

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObligatorio

      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
  • errorobjectObligatorio
    • codestringObligatorio

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

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObligatorio

      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
  • errorobjectObligatorio
    • codestringObligatorio

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

      pattern: ^[a-z][a-z0-9_]*$
    • messagestringObligatorio

      For people; may change at any time.

    • request_idOpcionalstring
    • fieldsOpcionalmap ofarray<string>

      Only for validation_failed, the messages per field.

Nuevo

2 de 7 pasos hechosSigue: la plataforma en producción

Qomni está en beta privada

La API y la app todavía no están abiertas. Mira qué está hecho, qué falta y cómo se abre, paso a paso hasta el primer cliente.

Escribe para buscar…

↑↓ moverte↵ abrirEsc para cerrar