TuCloudAPI addextension - Revision history

Maintenance script: TuCloudAPI reference (generated from func=help): field+reason, 700-703 reserved

2026-11-02T10:18:08Z

TuCloudAPI reference (generated from func=help): field+reason, 700-703 reserved

← Older revision		Revision as of 10:18, 2 November 2026
Line 4:		Line 4:

	== Description ==		== Description ==
	Create an extension. num is the user's choice, checked exactly like checkextnum but under a lock shared with addqueue: registered 3-4 digits, blank = next_free; send-to (toext_id set) 3-8 digits and REQUIRED (it is the remote PBX's number); no leading 0; 112 reserved; not an extension or queue of this PBX; SIP name free in the root. The server derives the SIP user (pbxname+num) and — unless password is supplied — a random SIP password; root/tucloudpbx_id come from the tenant. Every lookup id is validated to belong to this PBX. EVERY refusal carries field, reason and message: invalid_param with field num (required \| format \| reserved) or a lookup field (cli_id, internalcli_id, toext_id, music, outs_id, backupmonpeer; reason required \| not_found \| self); conflict with field num (extension \| queue \| unavailable \| full) or teamsnum (teams). The SIP peer + voicemail are created automatically by the DB trigger. Requires a non-readonly ukey. Password is NOT returned (use getextqr).		Create an extension. num is the user's choice, checked exactly like checkextnum but under a lock shared with addqueue: registered 3-4 digits, blank = next_free; send-to (toext_id set) 3-8 digits and REQUIRED (it is the remote PBX's number); no leading 0; 112 and 700-703 reserved; not an extension or queue of this PBX; SIP name free in the root. The server derives the SIP user (pbxname+num) and — unless password is supplied — a random SIP password; root/tucloudpbx_id come from the tenant. Every lookup id is validated to belong to this PBX. EVERY refusal carries field, reason and message: invalid_param with field num (required \| format \| reserved) or a lookup field (cli_id, internalcli_id, toext_id, music, outs_id, backupmonpeer; reason required \| not_found \| self); conflict with field num (extension \| queue \| unavailable \| full) or teamsnum (teams). The SIP peer + voicemail are created automatically by the DB trigger. Requires a non-readonly ukey. Password is NOT returned (use getextqr).

	== Call ==		== Call ==
Line 20:		Line 20:
	\| <code>cli_id</code> \|\| integer \|\| Yes \|\| — \|\| Outgoing caller ID id (required; from getextlookups.clis).		\| <code>cli_id</code> \|\| integer \|\| Yes \|\| — \|\| Outgoing caller ID id (required; from getextlookups.clis).
	\|-		\|-
	\| <code>num</code> \|\| string \|\| No \|\| — \|\| Extension number. Registered: 3-4 digits, blank = next_free. Send-to (toext_id set): 3-8 digits, required. Never a leading 0; 112 reserved.		\| <code>num</code> \|\| string \|\| No \|\| — \|\| Extension number. Registered: 3-4 digits, blank = next_free. Send-to (toext_id set): 3-8 digits, required. Never a leading 0; 112 and 700-703 reserved.
	\|-		\|-
	\| <code>ringtime</code> \|\| integer \|\| No \|\| <code>0</code> \|\| Ring seconds: 0 (PBX default) or 5-50.		\| <code>ringtime</code> \|\| integer \|\| No \|\| <code>0</code> \|\| Ring seconds: 0 (PBX default) or 5-50.

Maintenance script: TuCloudAPI reference (generated from func=help): checkextnum, extension numbers

2026-11-02T09:45:03Z

TuCloudAPI reference (generated from func=help): checkextnum, extension numbers

← Older revision		Revision as of 09:45, 2 November 2026
Line 4:		Line 4:

	== Description ==		== Description ==
	Create an extension. ~~The server derives~~ num ~~(max+1~~, ~~else 200~~; ~~112~~-~~>113~~), the SIP user (pbxname+num) and — unless password is supplied — a random SIP password; root/tucloudpbx_id come from the tenant. Every lookup id is validated to belong to this PBX. ~~Unique (pbx~~,num) ~~-> {ok:false~~,conflict}. The SIP peer + voicemail are created automatically by the DB trigger. Requires a non-readonly ukey. Password is NOT returned (use getextqr).		Create an extension. num is the user's choice, checked exactly like checkextnum but under a lock shared with addqueue: registered 3-4 digits, blank = next_free; send-to (toext_id set) 3-8 digits and REQUIRED (it is the remote PBX's number); no leading 0; 112 reserved; not an extension or queue of this PBX; SIP name free in the root. The server derives the SIP user (pbxname+num) and — unless password is supplied — a random SIP password; root/tucloudpbx_id come from the tenant. Every lookup id is validated to belong to this PBX. EVERY refusal carries field, reason and message: invalid_param with field num (required \| format \| reserved) or a lookup field (cli_id, internalcli_id, toext_id, music, outs_id, backupmonpeer; reason required \| not_found \| self); conflict with field num (extension \| queue \| unavailable \| full) or teamsnum (teams). The SIP peer + voicemail are created automatically by the DB trigger. Requires a non-readonly ukey. Password is NOT returned (use getextqr).

	== Call ==		== Call ==
Line 19:		Line 19:
	\|-		\|-
	\| <code>cli_id</code> \|\| integer \|\| Yes \|\| — \|\| Outgoing caller ID id (required; from getextlookups.clis).		\| <code>cli_id</code> \|\| integer \|\| Yes \|\| — \|\| Outgoing caller ID id (required; from getextlookups.clis).
			\|-
			\| <code>num</code> \|\| string \|\| No \|\| — \|\| Extension number. Registered: 3-4 digits, blank = next_free. Send-to (toext_id set): 3-8 digits, required. Never a leading 0; 112 reserved.
	\|-		\|-
	\| <code>ringtime</code> \|\| integer \|\| No \|\| <code>0</code> \|\| Ring seconds: 0 (PBX default) or 5-50.		\| <code>ringtime</code> \|\| integer \|\| No \|\| <code>0</code> \|\| Ring seconds: 0 (PBX default) or 5-50.
Line 30:		Line 32:
	\| <code>pickupgroup</code> \|\| integer \|\| No \|\| <code>0</code> \|\| Pickup group 0-999.		\| <code>pickupgroup</code> \|\| integer \|\| No \|\| <code>0</code> \|\| Pickup group 0-999.
	\|-		\|-
	\| <code>toext_id</code> \|\| integer \|\| No \|\| <code>0</code> \|\| Send-to extension id (0 = registered SIP mode).		\| <code>toext_id</code> \|\| integer \|\| No \|\| <code>0</code> \|\| Send-to extension id (0 = registered SIP mode). Set = num required, 3-8 digits.
	\|-		\|-
	\| <code>password</code> \|\| string \|\| No \|\| — \|\| Explicit SIP password (blank = auto-generate).		\| <code>password</code> \|\| string \|\| No \|\| — \|\| Explicit SIP password (blank = auto-generate).

Maintenance script: TuCloudAPI reference (generated from func=help): translator_langs/translator_lang sent empty clears

2026-10-28T19:49:04Z

TuCloudAPI reference (generated from func=help): translator_langs/translator_lang sent empty clears

← Older revision		Revision as of 19:49, 28 October 2026
Line 68:		Line 68:
	\| <code>nota</code> \|\| string \|\| No \|\| — \|\| Free note (max 256).		\| <code>nota</code> \|\| string \|\| No \|\| — \|\| Free note (max 256).
	\|-		\|-
	\| <code>translator_langs</code> \|\| string \|\| No \|\| — \|\| Idiomas que el usuario ENTIENDE, separados por comas (ej. "es,ca,en"), máx. 64. Si la otra parte habla uno de estos, no se traduce ni se factura. Se RECHAZA si excede 64: truncar dejaría fuera el último idioma y traduciría (y cobraría) llamadas que el usuario ya entendía.		\| <code>translator_langs</code> \|\| string \|\| No \|\| — \|\| Idiomas que el usuario ENTIENDE, separados por comas (ej. "es,ca,en"), máx. 64. Si la otra parte habla uno de estos, no se traduce ni se factura. Se RECHAZA si excede 64: truncar dejaría fuera el último idioma y traduciría (y cobraría) llamadas que el usuario ya entendía. Omitirlo CONSERVA la lista guardada; enviarlo VACÍO la BORRA (desde el 2026-10-28; antes vacío contaba como omitido y la lista no se podía vaciar).
	\|-		\|-
	\| <code>translator_lang</code> \|\| string \|\| No \|\| — \|\| Idioma de la traducción. Obligatorio si translator_mode no es 0; con modo 0 se IGNORA. Debe ser un código de la tabla oficial del servicio, EXACTO y respetando las mayúsculas: «pt-BR» vale y «pt-br», «PT-BR» o «ES» se rechazan. Guion, nunca subrayado. Los 79 códigos admitidos: af ak sq am ar hy az eu be bn bg my ca zh-Hans zh-Hant hr cs da nl en et fil fi fr gl ka de el gu ha he hi hu is id it ja jv kn kk km rw ko lo lv lt mk ms ml mr mn ne no nb fa pl pt-BR pt-PT pa ro ru sr sd si sk sl es su sw sv ta te th tr uk ur uz vi zu. OJO: el portugués y el chino SOLO existen como pt-BR/pt-PT y zh-Hans/zh-Hant — no hay «pt» ni «zh» a secas. Un código fuera de la tabla se rechaza aquí a propósito: el servicio aceptaría el armado y cerraría la sesión después, así que la llamada saldría SIN traducir, sin señal en la centralita y con la detección facturada igual. Los cuatro códigos con guion (pt-BR, pt-PT, zh-Hans, zh-Hant) estuvieron retenidos hasta el 2026-10-01 porque el motor aún no los traducía; ya están disponibles y se aceptan como el resto.		\| <code>translator_lang</code> \|\| string \|\| No \|\| — \|\| Idioma de la traducción. Obligatorio si translator_mode no es 0; con modo 0 se IGNORA. Debe ser un código de la tabla oficial del servicio, EXACTO y respetando las mayúsculas: «pt-BR» vale y «pt-br», «PT-BR» o «ES» se rechazan. Guion, nunca subrayado. Los 79 códigos admitidos: af ak sq am ar hy az eu be bn bg my ca zh-Hans zh-Hant hr cs da nl en et fil fi fr gl ka de el gu ha he hi hu is id it ja jv kn kk km rw ko lo lv lt mk ms ml mr mn ne no nb fa pl pt-BR pt-PT pa ro ru sr sd si sk sl es su sw sv ta te th tr uk ur uz vi zu. OJO: el portugués y el chino SOLO existen como pt-BR/pt-PT y zh-Hans/zh-Hant — no hay «pt» ni «zh» a secas. Un código fuera de la tabla se rechaza aquí a propósito: el servicio aceptaría el armado y cerraría la sesión después, así que la llamada saldría SIN traducir, sin señal en la centralita y con la detección facturada igual. Los cuatro códigos con guion (pt-BR, pt-PT, zh-Hans, zh-Hant) estuvieron retenidos hasta el 2026-10-01 porque el motor aún no los traducía; ya están disponibles y se aceptan como el resto. Omitirlo CONSERVA el valor guardado; enviarlo VACÍO lo BORRA (desde el 2026-10-28), lo que solo cabe con translator_mode 0, porque con un modo distinto de 0 es obligatorio y el vacío se rechaza.
	\|-		\|-
	\| <code>translator_mode</code> \|\| integer \|\| No \|\| — \|\| Máscara de bits (OR de flags), 0 = desactivada, rango 0-63. ÁMBITO, elige QUÉ llamadas se traducen: 1 = entrante externa (una llamada de fuera/DID llega a esta extensión); 2 = saliente externa (esta extensión llama a un número externo/RTC); 4 = entrante interna (otra extensión del mismo PBX llama a esta); 8 = saliente interna (esta extensión llama a otra del mismo PBX). MODIFICADOR, elige EN QUÉ LADO se detecta el idioma: 16 = translator_lang es el idioma del INTERLOCUTOR y no el de esta extensión, así que se detecta siempre el de esta y se traduce al configurado para el otro lado; sirve igual en entrantes y salientes. 32 = ESCUCHA PROLONGADA (en el motor, «traducción permanente» acotada por su VENTANA DE IDIOMA): toda llamada se escucha como máximo los primeros 30 s desde que se contesta. Sin este bit, si al lado que se detecta se le reconoce un idioma que el otro lado ya entiende, la traducción de ESA llamada se desactiva en el acto (unos 2-3 s de escucha, lo más barato); con el bit no se desactiva por eso: se sigue escuchando hasta cumplir los 30 s por si aparece otro idioma (audio malo, saludo con eco), y esa escucha se factura. En los dos casos, sin idioma extranjero confirmado a los 30 s el motor se apaga del todo (coste máximo ~30 s); confirmado dentro de la ventana, se traduce hasta colgar. Un idioma de translator_lang o translator_langs NUNCA se traduce, con el bit o sin él, y el motor nunca traduce por suposición: confirma el idioma extranjero con una segunda comprobación sobre el audio real, así que la primera frase del extranjero (1-2 s) no se locuta. Hasta el 2026-10-28 este texto decía «no se apaga nunca, toda la llamada»: ya no es así. Sirve sobre todo cuando el lado detectado es un manos libres: la voz del otro, captada por su micrófono, puede reconocerse como idioma de ese lado y apagar la traducción antes de tiempo. En una decisión conjunta basta que lo tenga UNA de las filas que participa. 16 y 32 son MODIFICADORES: no activan nada por sí solos, así que un modo con solo modificadores y ningún ámbito se rechaza — marca también cuándo traducir, o deja el modo en 0. UNA SOLA sesión de traducción por llamada, nunca dos. Quién la decide, en una llamada interna (a otra extensión o a un grupo): (a) si esta extensión tiene el bit 16 Y LOS DOS bits de saliente (2 y 8) Y un idioma válido, la arma ella al empezar la llamada, antes de saber el destino, y los ajustes del destino NO se usan; (b) en cualquier otro caso basta que el que llama tenga su bit 8 O el llamado su bit 4, y se toma UNA decisión conjunta con las DOS filas: el idioma del que llama para su pata, el del llamado para la suya, y la lista de idiomas que entiende cada uno — si hablan el mismo idioma o se entienden, no se arma nada. Un lado con translator_mode 0 NO declara nada: su idioma y su lista se ignoran a propósito, para que un dato viejo no pueda vetar en silencio lo que el otro lado sí pidió; su pata se queda en automático y el motor detecta lo que oye. Entrante por un DID (bit 1): decide el destino, salvo que quien llame sea un número de este mismo PBX — esa llamada la puso la centralita y ahí no se arma nada. Un modo distinto de 0 con translator_lang vacío se rechaza: el traductor no se armaría y la llamada no se traduciría sin que nada lo indicase. Omitir el parámetro CONSERVA el valor.		\| <code>translator_mode</code> \|\| integer \|\| No \|\| — \|\| Máscara de bits (OR de flags), 0 = desactivada, rango 0-63. ÁMBITO, elige QUÉ llamadas se traducen: 1 = entrante externa (una llamada de fuera/DID llega a esta extensión); 2 = saliente externa (esta extensión llama a un número externo/RTC); 4 = entrante interna (otra extensión del mismo PBX llama a esta); 8 = saliente interna (esta extensión llama a otra del mismo PBX). MODIFICADOR, elige EN QUÉ LADO se detecta el idioma: 16 = translator_lang es el idioma del INTERLOCUTOR y no el de esta extensión, así que se detecta siempre el de esta y se traduce al configurado para el otro lado; sirve igual en entrantes y salientes. 32 = ESCUCHA PROLONGADA (en el motor, «traducción permanente» acotada por su VENTANA DE IDIOMA): toda llamada se escucha como máximo los primeros 30 s desde que se contesta. Sin este bit, si al lado que se detecta se le reconoce un idioma que el otro lado ya entiende, la traducción de ESA llamada se desactiva en el acto (unos 2-3 s de escucha, lo más barato); con el bit no se desactiva por eso: se sigue escuchando hasta cumplir los 30 s por si aparece otro idioma (audio malo, saludo con eco), y esa escucha se factura. En los dos casos, sin idioma extranjero confirmado a los 30 s el motor se apaga del todo (coste máximo ~30 s); confirmado dentro de la ventana, se traduce hasta colgar. Un idioma de translator_lang o translator_langs NUNCA se traduce, con el bit o sin él, y el motor nunca traduce por suposición: confirma el idioma extranjero con una segunda comprobación sobre el audio real, así que la primera frase del extranjero (1-2 s) no se locuta. Hasta el 2026-10-28 este texto decía «no se apaga nunca, toda la llamada»: ya no es así. Sirve sobre todo cuando el lado detectado es un manos libres: la voz del otro, captada por su micrófono, puede reconocerse como idioma de ese lado y apagar la traducción antes de tiempo. En una decisión conjunta basta que lo tenga UNA de las filas que participa. 16 y 32 son MODIFICADORES: no activan nada por sí solos, así que un modo con solo modificadores y ningún ámbito se rechaza — marca también cuándo traducir, o deja el modo en 0. UNA SOLA sesión de traducción por llamada, nunca dos. Quién la decide, en una llamada interna (a otra extensión o a un grupo): (a) si esta extensión tiene el bit 16 Y LOS DOS bits de saliente (2 y 8) Y un idioma válido, la arma ella al empezar la llamada, antes de saber el destino, y los ajustes del destino NO se usan; (b) en cualquier otro caso basta que el que llama tenga su bit 8 O el llamado su bit 4, y se toma UNA decisión conjunta con las DOS filas: el idioma del que llama para su pata, el del llamado para la suya, y la lista de idiomas que entiende cada uno — si hablan el mismo idioma o se entienden, no se arma nada. Un lado con translator_mode 0 NO declara nada: su idioma y su lista se ignoran a propósito, para que un dato viejo no pueda vetar en silencio lo que el otro lado sí pidió; su pata se queda en automático y el motor detecta lo que oye. Entrante por un DID (bit 1): decide el destino, salvo que quien llame sea un número de este mismo PBX — esa llamada la puso la centralita y ahí no se arma nada. Un modo distinto de 0 con translator_lang vacío se rechaza: el traductor no se armaría y la llamada no se traduciría sin que nada lo indicase. Omitir el parámetro CONSERVA el valor.

Maintenance script: TuCloudAPI reference (generated from func=help): translator_mode bit 32 is long listen

2026-10-28T19:24:01Z

TuCloudAPI reference (generated from func=help): translator_mode bit 32 is long listen

← Older revision		Revision as of 19:24, 28 October 2026
Line 72:		Line 72:
	\| <code>translator_lang</code> \|\| string \|\| No \|\| — \|\| Idioma de la traducción. Obligatorio si translator_mode no es 0; con modo 0 se IGNORA. Debe ser un código de la tabla oficial del servicio, EXACTO y respetando las mayúsculas: «pt-BR» vale y «pt-br», «PT-BR» o «ES» se rechazan. Guion, nunca subrayado. Los 79 códigos admitidos: af ak sq am ar hy az eu be bn bg my ca zh-Hans zh-Hant hr cs da nl en et fil fi fr gl ka de el gu ha he hi hu is id it ja jv kn kk km rw ko lo lv lt mk ms ml mr mn ne no nb fa pl pt-BR pt-PT pa ro ru sr sd si sk sl es su sw sv ta te th tr uk ur uz vi zu. OJO: el portugués y el chino SOLO existen como pt-BR/pt-PT y zh-Hans/zh-Hant — no hay «pt» ni «zh» a secas. Un código fuera de la tabla se rechaza aquí a propósito: el servicio aceptaría el armado y cerraría la sesión después, así que la llamada saldría SIN traducir, sin señal en la centralita y con la detección facturada igual. Los cuatro códigos con guion (pt-BR, pt-PT, zh-Hans, zh-Hant) estuvieron retenidos hasta el 2026-10-01 porque el motor aún no los traducía; ya están disponibles y se aceptan como el resto.		\| <code>translator_lang</code> \|\| string \|\| No \|\| — \|\| Idioma de la traducción. Obligatorio si translator_mode no es 0; con modo 0 se IGNORA. Debe ser un código de la tabla oficial del servicio, EXACTO y respetando las mayúsculas: «pt-BR» vale y «pt-br», «PT-BR» o «ES» se rechazan. Guion, nunca subrayado. Los 79 códigos admitidos: af ak sq am ar hy az eu be bn bg my ca zh-Hans zh-Hant hr cs da nl en et fil fi fr gl ka de el gu ha he hi hu is id it ja jv kn kk km rw ko lo lv lt mk ms ml mr mn ne no nb fa pl pt-BR pt-PT pa ro ru sr sd si sk sl es su sw sv ta te th tr uk ur uz vi zu. OJO: el portugués y el chino SOLO existen como pt-BR/pt-PT y zh-Hans/zh-Hant — no hay «pt» ni «zh» a secas. Un código fuera de la tabla se rechaza aquí a propósito: el servicio aceptaría el armado y cerraría la sesión después, así que la llamada saldría SIN traducir, sin señal en la centralita y con la detección facturada igual. Los cuatro códigos con guion (pt-BR, pt-PT, zh-Hans, zh-Hant) estuvieron retenidos hasta el 2026-10-01 porque el motor aún no los traducía; ya están disponibles y se aceptan como el resto.
	\|-		\|-
	\| <code>translator_mode</code> \|\| integer \|\| No \|\| — \|\| Máscara de bits (OR de flags), 0 = desactivada, rango 0-63. ÁMBITO, elige QUÉ llamadas se traducen: 1 = entrante externa (una llamada de fuera/DID llega a esta extensión); 2 = saliente externa (esta extensión llama a un número externo/RTC); 4 = entrante interna (otra extensión del mismo PBX llama a esta); 8 = saliente interna (esta extensión llama a otra del mismo PBX). MODIFICADOR, elige EN QUÉ LADO se detecta el idioma: 16 = translator_lang es el idioma del INTERLOCUTOR y no el de esta extensión, así que se detecta siempre el de esta y se traduce al configurado para el otro lado; sirve igual en entrantes y salientes. 32 = ~~TRADUCCIÓN PERMANENTE~~: ~~sin~~ este bit, si ~~el idioma~~ que se detecta ~~resulta ser uno~~ que el otro lado ya entiende, la traducción de ESA llamada se ~~apaga hasta colgar y no se traduce nada~~ más ~~aunque cambie el idioma — así se ahorra el coste. Con~~ el bit ~~32 la llamada~~ no se ~~apaga nunca~~: se sigue escuchando y se traduce ~~en cuanto~~ se ~~oye un~~ idioma ~~ajeno~~, ~~y mientras solo se hablen idiomas entendidos~~ no se ~~dice nada (~~el ~~español no~~ se ~~repite en español); la escucha se factura~~ toda la ~~llamada~~. ~~Importa~~ sobre todo cuando el lado detectado es un manos libres: la voz del otro, captada por su micrófono, puede ~~detectarse~~ como idioma de ese lado y ~~dejar~~ la ~~llamada sin~~ traducción ~~para siempre~~. En una decisión conjunta basta que lo tenga UNA de las filas que participa. 16 y 32 son MODIFICADORES: no activan nada por sí solos, así que un modo con solo modificadores y ningún ámbito se rechaza — marca también cuándo traducir, o deja el modo en 0. UNA SOLA sesión de traducción por llamada, nunca dos. Quién la decide, en una llamada interna (a otra extensión o a un grupo): (a) si esta extensión tiene el bit 16 Y LOS DOS bits de saliente (2 y 8) Y un idioma válido, la arma ella al empezar la llamada, antes de saber el destino, y los ajustes del destino NO se usan; (b) en cualquier otro caso basta que el que llama tenga su bit 8 O el llamado su bit 4, y se toma UNA decisión conjunta con las DOS filas: el idioma del que llama para su pata, el del llamado para la suya, y la lista de idiomas que entiende cada uno — si hablan el mismo idioma o se entienden, no se arma nada. Un lado con translator_mode 0 NO declara nada: su idioma y su lista se ignoran a propósito, para que un dato viejo no pueda vetar en silencio lo que el otro lado sí pidió; su pata se queda en automático y el motor detecta lo que oye. Entrante por un DID (bit 1): decide el destino, salvo que quien llame sea un número de este mismo PBX — esa llamada la puso la centralita y ahí no se arma nada. Un modo distinto de 0 con translator_lang vacío se rechaza: el traductor no se armaría y la llamada no se traduciría sin que nada lo indicase. Omitir el parámetro CONSERVA el valor.		\| <code>translator_mode</code> \|\| integer \|\| No \|\| — \|\| Máscara de bits (OR de flags), 0 = desactivada, rango 0-63. ÁMBITO, elige QUÉ llamadas se traducen: 1 = entrante externa (una llamada de fuera/DID llega a esta extensión); 2 = saliente externa (esta extensión llama a un número externo/RTC); 4 = entrante interna (otra extensión del mismo PBX llama a esta); 8 = saliente interna (esta extensión llama a otra del mismo PBX). MODIFICADOR, elige EN QUÉ LADO se detecta el idioma: 16 = translator_lang es el idioma del INTERLOCUTOR y no el de esta extensión, así que se detecta siempre el de esta y se traduce al configurado para el otro lado; sirve igual en entrantes y salientes. 32 = ESCUCHA PROLONGADA (en el motor, «traducción permanente» acotada por su VENTANA DE IDIOMA): toda llamada se escucha como máximo los primeros 30 s desde que se contesta. Sin este bit, si al lado que se detecta se le reconoce un idioma que el otro lado ya entiende, la traducción de ESA llamada se desactiva en el acto (unos 2-3 s de escucha, lo más barato); con el bit no se desactiva por eso: se sigue escuchando hasta cumplir los 30 s por si aparece otro idioma (audio malo, saludo con eco), y esa escucha se factura. En los dos casos, sin idioma extranjero confirmado a los 30 s el motor se apaga del todo (coste máximo ~30 s); confirmado dentro de la ventana, se traduce hasta colgar. Un idioma de translator_lang o translator_langs NUNCA se traduce, con el bit o sin él, y el motor nunca traduce por suposición: confirma el idioma extranjero con una segunda comprobación sobre el audio real, así que la primera frase del extranjero (1-2 s) no se locuta. Hasta el 2026-10-28 este texto decía «no se apaga nunca, toda la llamada»: ya no es así. Sirve sobre todo cuando el lado detectado es un manos libres: la voz del otro, captada por su micrófono, puede reconocerse como idioma de ese lado y apagar la traducción antes de tiempo. En una decisión conjunta basta que lo tenga UNA de las filas que participa. 16 y 32 son MODIFICADORES: no activan nada por sí solos, así que un modo con solo modificadores y ningún ámbito se rechaza — marca también cuándo traducir, o deja el modo en 0. UNA SOLA sesión de traducción por llamada, nunca dos. Quién la decide, en una llamada interna (a otra extensión o a un grupo): (a) si esta extensión tiene el bit 16 Y LOS DOS bits de saliente (2 y 8) Y un idioma válido, la arma ella al empezar la llamada, antes de saber el destino, y los ajustes del destino NO se usan; (b) en cualquier otro caso basta que el que llama tenga su bit 8 O el llamado su bit 4, y se toma UNA decisión conjunta con las DOS filas: el idioma del que llama para su pata, el del llamado para la suya, y la lista de idiomas que entiende cada uno — si hablan el mismo idioma o se entienden, no se arma nada. Un lado con translator_mode 0 NO declara nada: su idioma y su lista se ignoran a propósito, para que un dato viejo no pueda vetar en silencio lo que el otro lado sí pidió; su pata se queda en automático y el motor detecta lo que oye. Entrante por un DID (bit 1): decide el destino, salvo que quien llame sea un número de este mismo PBX — esa llamada la puso la centralita y ahí no se arma nada. Un modo distinto de 0 con translator_lang vacío se rechaza: el traductor no se armaría y la llamada no se traduciría sin que nada lo indicase. Omitir el parámetro CONSERVA el valor.
	\|}		\|}
	== Example ==		== Example ==

Maintenance script: TuCloudAPI reference regenerated from func=help: tenancy rule, pbx notes on every PBX-scoped function, error codes

2026-10-08T21:16:19Z

TuCloudAPI reference regenerated from func=help: tenancy rule, pbx notes on every PBX-scoped function, error codes

← Older revision		Revision as of 21:16, 8 October 2026
Line 1:		Line 1:
	''TuCloudAPI function to manage FuturePBX (the cloud PBX). Available to: '''SuperRoot, Operator, Client'''.''		''TuCloudAPI function to manage FuturePBX (the cloud PBX). Available to: '''SuperRoot, Operator, Client'''.''

			{{Note\|1=Requires the <code>pbx</code> parameter (the PBX '''name''', e.g. <code>tucall</code>). The server verifies that your <code>ukey</code>'s own account owns that PBX, whatever its role; otherwise, and also for a PBX that does not exist, it returns <code>{"ok":false,"code":"forbidden"}</code>.}}

	== Description ==		== Description ==
Line 5:		Line 7:

	== Call ==		== Call ==
	~~GET~~ https://tucloudapi.7kas.com:9087/tucloud?func=addextension&ukey=YOUR_KEY		https://tucloudapi.7kas.com:9087/tucloud?func=addextension&ukey=YOUR_KEY&pbx=PBX_NAME
	Requires the <code>ukey</code> parameter.		GET, or POST with the parameters form-urlencoded in the body. Requires the <code>ukey</code> parameter. Always HTTP 200; the response is a JSON envelope.

	== Parameters ==		== Parameters ==
Line 65:		Line 67:
	\|-		\|-
	\| <code>nota</code> \|\| string \|\| No \|\| — \|\| Free note (max 256).		\| <code>nota</code> \|\| string \|\| No \|\| — \|\| Free note (max 256).
			\|-
			\| <code>translator_langs</code> \|\| string \|\| No \|\| — \|\| Idiomas que el usuario ENTIENDE, separados por comas (ej. "es,ca,en"), máx. 64. Si la otra parte habla uno de estos, no se traduce ni se factura. Se RECHAZA si excede 64: truncar dejaría fuera el último idioma y traduciría (y cobraría) llamadas que el usuario ya entendía.
			\|-
			\| <code>translator_lang</code> \|\| string \|\| No \|\| — \|\| Idioma de la traducción. Obligatorio si translator_mode no es 0; con modo 0 se IGNORA. Debe ser un código de la tabla oficial del servicio, EXACTO y respetando las mayúsculas: «pt-BR» vale y «pt-br», «PT-BR» o «ES» se rechazan. Guion, nunca subrayado. Los 79 códigos admitidos: af ak sq am ar hy az eu be bn bg my ca zh-Hans zh-Hant hr cs da nl en et fil fi fr gl ka de el gu ha he hi hu is id it ja jv kn kk km rw ko lo lv lt mk ms ml mr mn ne no nb fa pl pt-BR pt-PT pa ro ru sr sd si sk sl es su sw sv ta te th tr uk ur uz vi zu. OJO: el portugués y el chino SOLO existen como pt-BR/pt-PT y zh-Hans/zh-Hant — no hay «pt» ni «zh» a secas. Un código fuera de la tabla se rechaza aquí a propósito: el servicio aceptaría el armado y cerraría la sesión después, así que la llamada saldría SIN traducir, sin señal en la centralita y con la detección facturada igual. Los cuatro códigos con guion (pt-BR, pt-PT, zh-Hans, zh-Hant) estuvieron retenidos hasta el 2026-10-01 porque el motor aún no los traducía; ya están disponibles y se aceptan como el resto.
			\|-
			\| <code>translator_mode</code> \|\| integer \|\| No \|\| — \|\| Máscara de bits (OR de flags), 0 = desactivada, rango 0-63. ÁMBITO, elige QUÉ llamadas se traducen: 1 = entrante externa (una llamada de fuera/DID llega a esta extensión); 2 = saliente externa (esta extensión llama a un número externo/RTC); 4 = entrante interna (otra extensión del mismo PBX llama a esta); 8 = saliente interna (esta extensión llama a otra del mismo PBX). MODIFICADOR, elige EN QUÉ LADO se detecta el idioma: 16 = translator_lang es el idioma del INTERLOCUTOR y no el de esta extensión, así que se detecta siempre el de esta y se traduce al configurado para el otro lado; sirve igual en entrantes y salientes. 32 = TRADUCCIÓN PERMANENTE: sin este bit, si el idioma que se detecta resulta ser uno que el otro lado ya entiende, la traducción de ESA llamada se apaga hasta colgar y no se traduce nada más aunque cambie el idioma — así se ahorra el coste. Con el bit 32 la llamada no se apaga nunca: se sigue escuchando y se traduce en cuanto se oye un idioma ajeno, y mientras solo se hablen idiomas entendidos no se dice nada (el español no se repite en español); la escucha se factura toda la llamada. Importa sobre todo cuando el lado detectado es un manos libres: la voz del otro, captada por su micrófono, puede detectarse como idioma de ese lado y dejar la llamada sin traducción para siempre. En una decisión conjunta basta que lo tenga UNA de las filas que participa. 16 y 32 son MODIFICADORES: no activan nada por sí solos, así que un modo con solo modificadores y ningún ámbito se rechaza — marca también cuándo traducir, o deja el modo en 0. UNA SOLA sesión de traducción por llamada, nunca dos. Quién la decide, en una llamada interna (a otra extensión o a un grupo): (a) si esta extensión tiene el bit 16 Y LOS DOS bits de saliente (2 y 8) Y un idioma válido, la arma ella al empezar la llamada, antes de saber el destino, y los ajustes del destino NO se usan; (b) en cualquier otro caso basta que el que llama tenga su bit 8 O el llamado su bit 4, y se toma UNA decisión conjunta con las DOS filas: el idioma del que llama para su pata, el del llamado para la suya, y la lista de idiomas que entiende cada uno — si hablan el mismo idioma o se entienden, no se arma nada. Un lado con translator_mode 0 NO declara nada: su idioma y su lista se ignoran a propósito, para que un dato viejo no pueda vetar en silencio lo que el otro lado sí pidió; su pata se queda en automático y el motor detecta lo que oye. Entrante por un DID (bit 1): decide el destino, salvo que quien llame sea un número de este mismo PBX — esa llamada la puso la centralita y ahí no se arma nada. Un modo distinto de 0 con translator_lang vacío se rechaza: el traductor no se armaría y la llamada no se traduciría sin que nada lo indicase. Omitir el parámetro CONSERVA el valor.
	\|}		\|}
	== Example ==		== Example ==
Line 71:		Line 79:
	== Response ==		== Response ==
	{ok, ext:{...}} (no password).		{ok, ext:{...}} (no password).

			== Errors ==
			Always HTTP 200. On failure the body is <code>{"ok":false,"code":"...","message":"..."}</code>. Common codes: <code>missing_pbx</code>, <code>forbidden</code>, <code>invalid_param</code>, <code>not_found</code>, <code>conflict</code>, <code>in_use</code>, <code>db_error</code>, <code>server_busy</code>; the Response section above lists any specific to this function.

	----		----
	Back to [[TuCloudAPI]]		Back to [[TuCloudAPI]]
	[[Category:TuCloudAPI SuperRoot]][[Category:TuCloudAPI Operator]][[Category:TuCloudAPI Client]][[Category:TuCloudAPI]]		[[Category:TuCloudAPI SuperRoot]][[Category:TuCloudAPI Operator]][[Category:TuCloudAPI Client]][[Category:TuCloudAPI]]

Maintenance script: TuCloudAPI reference: pbx param help -> FuturePBX (API surface unchanged)

2026-08-03T14:30:52Z

TuCloudAPI reference: pbx param help -> FuturePBX (API surface unchanged)

← Older revision		Revision as of 14:30, 3 August 2026
Line 12:		Line 12:
	! Parameter !! Type !! Required !! Default !! Meaning		! Parameter !! Type !! Required !! Default !! Meaning
	\|-		\|-
	\| <code>pbx</code> \|\| string \|\| Yes \|\| — \|\| ~~TuCloud PBX~~ NAME (e.g. tucall). The (ukey, pbx) pair is the tenant boundary; the server verifies the ukey owns this PBX.		\| <code>pbx</code> \|\| string \|\| Yes \|\| — \|\| FuturePBX NAME (e.g. tucall). The (ukey, pbx) pair is the tenant boundary; the server verifies the ukey owns this PBX.
	\|-		\|-
	\| <code>name</code> \|\| string \|\| Yes \|\| — \|\| Display name (required, max 64).		\| <code>name</code> \|\| string \|\| Yes \|\| — \|\| Display name (required, max 64).

Maintenance script: TuCloudAPI reference: product name -> FuturePBX (API surface unchanged); regenerated from func=help

2026-08-03T14:13:53Z

TuCloudAPI reference: product name -> FuturePBX (API surface unchanged); regenerated from func=help

← Older revision		Revision as of 14:13, 3 August 2026
Line 1:		Line 1:
	''TuCloudAPI function to manage ~~tucloud~~ (PBX) ~~services~~. Available to: '''SuperRoot, Operator, Client'''.''		''TuCloudAPI function to manage FuturePBX (the cloud PBX). Available to: '''SuperRoot, Operator, Client'''.''

	== Description ==		== Description ==

Maintenance script: API docs (generated from func=help) — add #48 adminusers + #52 pbxconfig

2026-08-02T04:37:51Z

API docs (generated from func=help) — add #48 adminusers + #52 pbxconfig

New page

''TuCloudAPI function to manage tucloud (PBX) services. Available to: '''SuperRoot, Operator, Client'''.''

== Description ==
Create an extension. The server derives num (max+1, else 200; 112->113), the SIP user (pbxname+num) and — unless password is supplied — a random SIP password; root/tucloudpbx_id come from the tenant. Every lookup id is validated to belong to this PBX. Unique (pbx,num) -> {ok:false,conflict}. The SIP peer + voicemail are created automatically by the DB trigger. Requires a non-readonly ukey. Password is NOT returned (use getextqr).

== Call ==
GET https://tucloudapi.7kas.com:9087/tucloud?func=addextension&ukey=YOUR_KEY
Requires the <code>ukey</code> parameter.

== Parameters ==
{| class="wikitable sortable"
! Parameter !! Type !! Required !! Default !! Meaning
|-
| <code>pbx</code> || string || Yes || — || TuCloud PBX NAME (e.g. tucall). The (ukey, pbx) pair is the tenant boundary; the server verifies the ukey owns this PBX.
|-
| <code>name</code> || string || Yes || — || Display name (required, max 64).
|-
| <code>cli_id</code> || integer || Yes || — || Outgoing caller ID id (required; from getextlookups.clis).
|-
| <code>ringtime</code> || integer || No || <code>0</code> || Ring seconds: 0 (PBX default) or 5-50.
|-
| <code>internalcli_id</code> || integer || No || <code>0</code> || Internal/mobile CLI id (0 = none).
|-
| <code>teamsopt</code> || string || No || <code>S</code> || T=Teams, S=VoIP, TS=both.
|-
| <code>teamsnum</code> || string || No || — || Teams number (digits only, max 64; unique).
|-
| <code>pickupgroup</code> || integer || No || <code>0</code> || Pickup group 0-999.
|-
| <code>toext_id</code> || integer || No || <code>0</code> || Send-to extension id (0 = registered SIP mode).
|-
| <code>password</code> || string || No || — || Explicit SIP password (blank = auto-generate).
|-
| <code>backupnum</code> || string || No || — || Backup number (digits and +, max 64).
|-
| <code>backupmonpeer</code> || string || No || — || Extension num to monitor for backup.
|-
| <code>music</code> || integer || No || <code>0</code> || Music-on-hold id (0 = default).
|-
| <code>tom</code> || integer || No || <code>0</code> || 0=tone, 1=music.
|-
| <code>voicemail</code> || integer || No || <code>0</code> || 1=enable voicemail.
|-
| <code>email</code> || string || No || — || Voicemail/notification email.
|-
| <code>incom_only_contacts</code> || integer || No || <code>0</code> || 1=accept only contacts/extensions.
|-
| <code>fwdshowcaller</code> || integer || No || <code>0</code> || 1=show original caller on forward.
|-
| <code>fwd_cli</code> || integer || No || <code>0</code> || External-forward caller-ID (0=Si,1=No; inverse).
|-
| <code>fwd</code> || integer || No || <code>0</code> || External forward: 0=off,1=all,2=busy,3=noanswer,4=busy/noanswer.
|-
| <code>fwdnum</code> || string || No || — || External forward destination.
|-
| <code>fwd_internal</code> || integer || No || <code>0</code> || Internal forward (same 0-4 scale).
|-
| <code>fwdnum_internal</code> || string || No || — || Internal forward destination.
|-
| <code>recoutgoing</code> || integer || No || <code>0</code> || 1=record outgoing calls.
|-
| <code>only_contacts</code> || integer || No || <code>0</code> || 1=restrict outbound to contacts.
|-
| <code>outs_id</code> || integer || No || <code>0</code> || Outgoing service id (0 = none).
|-
| <code>nota</code> || string || No || — || Free note (max 256).
|}
== Example ==
<nowiki>https://tucloudapi.7kas.com:9087/tucloud?func=addextension&ukey=KEY&pbx=tucall&name=Recepcion&cli_id=81324</nowiki>

== Response ==
{ok, ext:{...}} (no password).

----
Back to [[TuCloudAPI]]
[[Category:TuCloudAPI SuperRoot]][[Category:TuCloudAPI Operator]][[Category:TuCloudAPI Client]][[Category:TuCloudAPI]]