Límites y números de prueba

English version: Limits and test numbers.

Dos cosas que necesita saber una cuenta de desarrollador nueva: qué límites le aplican y cómo suben, y qué números usar mientras pruebas.

Niveles de confianza

Una cuenta creada por el registro público empieza en el nivel más bajo y sube con datos: días desde la activación, importe pagado acumulado y verificación. Un registro público que no ha verificado un teléfono no pasa del nivel más bajo (POST /v1/phone_verification envía un código de seis dígitos por SMS, POST /v1/phone_verification/check lo canjea y GET /v1/phone_verification lee el estado). Un operador de la plataforma puede subir o bajar un nivel a mano; una bajada manual detiene la subida automática hasta que un operador vuelve a subirlo.

El catálogo inicial, tal como se publicó en core v0.151.0:

Nivel	Nombre	Llamadas por segundo	Canales simultáneos	Tope de gasto diario (USD)	Tope por llamada (USD)	Destinos	Para llegar
0	new	1	2	10	2	nacional	—
1	established	3	5	50	5	nacional	7 días y 50 USD pagados
2	verified	10	20	500	10	nacional, internacional	30 días, 500 USD pagados y verificación
3	trusted	30	100	5.000	25	nacional, internacional, premium	90 días, 5.000 USD pagados y verificación

Estas cifras son datos de la plataforma, no constantes: la plataforma las ajusta a medida que aprende, así que toma la tabla como punto de partida. Una subcuenta lleva sus propios techos (max_cps, max_concurrent_channels, daily_spend_cap_usd) y el límite efectivo es siempre el menor entre el suyo y el de su cuenta madre (effective_limits; un valor por encima del de la madre es 422 exceeds_parent_limit).

Los límites no son el único freno. Las tasas de peticiones por clave (429 rate_limited) están en Límites de uso y topes, y las puertas de cumplimiento aplican a toda llamada real sea cual sea el nivel: ver Errores y cumplimiento.

Números de prueba

Con una clave dd_test_, POST /v1/dial/manual (number) y POST /v1/sms/messages (to, body) responden un resultado simulado determinista que elige el destino:

Número	status de la llamada	status del SMS
+13125550100	completed	delivered
+13125550101	busy	undelivered
+13125550102	no_answer	sent
+13125550103	failed	failed

• Cualquier otro destino es 422 unknown_test_number.
• Los registros se leen en GET /v1/sandbox/records (kind=call|sms, limit de 1 a 200), los más nuevos primero, aparte del CDR real (/v1/reports/cdr y /v1/sms/messages nunca los incluyen).
• Una llamada simulada también encola call.answered (sólo si contestó) y call.ended a tus endpoints suscritos, firmados como una entrega real, con livemode: false y environment: "test". El SMS no tiene webhook.
• Nada se mide ni se cobra, y las rutas que llegan a un operador, compran números o crean una credencial real responden 403 test_environment.

Recorrido: inicio rápido alojado. Todo code de error de arriba está en el índice de errores.