Números de Twilio en EE. UU. y Canadá: cada trámite, en el orden correcto.

La versión corta

Un número de Twilio que solo recibe llamadas hacia un menú telefónico necesita muy poco: se compra, se apunta su webhook de voz a su aplicación y listo. Cada cosa adicional que haga con el número agrega una obligación. Hacer llamadas desde él plantea preguntas sobre el identificador de llamadas, las llamadas de emergencia y el etiquetado de llamadas. Enviar mensajes de texto lo coloca en uno de dos esquemas de registro de las operadoras, según sea un número local o gratuito. Traer un número existente implica un proceso de portación cuyo papeleo difiere entre los dos países.

Por eso la forma útil de leer esta página es según lo que usted piensa hacer con el número. La lista de verificación al final está organizada así, con una columna "cuándo importa" para cada punto.

Dos cosas de esta página son fáciles de equivocar porque internet está lleno de consejos antiguos. Los mensajes de texto sin registrar desde números locales de EE. UU. no se "filtran más": están bloqueados por completo desde el 1 de septiembre de 2023.19 Y los mensajes desde un número gratuito sin verificar no tienen "límite de velocidad": están bloqueados desde el 31 de enero de 2024.22 Si un tutorial le dice que compre un número y envíe un SMS de prueba, se escribió antes de esas fechas o supone una cuenta de prueba.

Búsqueda de un número

El aprovisionamiento es un proceso de dos pasos. Twilio lo describe así: "Find an available phone number to provision by making a GET request to the subresources of the AvailablePhoneNumbers resource" (busque un número disponible con una solicitud GET a los subrecursos de AvailablePhoneNumbers) y luego "Make a POST request to the IncomingPhoneNumbers resource" (haga una solicitud POST al recurso IncomingPhoneNumbers).3 Buscar es gratis y no reserva nada; el número es suyo solo cuando el POST tiene éxito.

Los números locales se buscan en /2010-04-01/Accounts/{AccountSid}/AvailablePhoneNumbers/{CountryCode}/Local.json1 y los números gratuitos en la misma ruta terminada en /TollFree.json.2 El código de país es US o CA. Los filtros que importan para Norteamérica:

• AreaCode, que Twilio documenta como aplicable "to only phone numbers in the US and Canada" (solo a números de EE. UU. y Canadá).1
• Contains, un patrón de 2 a 16 caracteres que acepta dígitos y letras latinas, además de los metacaracteres *, %, + (ancla al inicio) y $ (ancla al final).1 Las letras permiten búsquedas de números "personalizados".
• Geografía: InRegion (estado o provincia), InPostalCode, InRateCenter (que exige InLata), y NearNumber o NearLatLong con un Distance que por defecto es 25 millas y puede llegar a 500. Todos funcionan solo en EE. UU. y Canadá.1
• Capacidades: VoiceEnabled, SmsEnabled, MmsEnabled, FaxEnabled.1
• Filtros de dirección: ExcludeAllAddressRequired, ExcludeLocalAddressRequired y ExcludeForeignAddressRequired, todos falsos por defecto.1
• Beta, que por defecto es true e incluye números "new to the Twilio platform" (nuevos en la plataforma de Twilio).1

Cada resultado trae su propio address_requirements (none, any, local o foreign) y un objeto capabilities.1 Lea ambos en el resultado en lugar de suponerlos por el país: son la declaración definitiva para ese número específico.

Búsqueda con la biblioteca auxiliar de Node.js, de números de Toronto con capacidad de voz que no necesitan dirección registrada:

const twilio = require("twilio");
const client = twilio(process.env.TWILIO_API_KEY, process.env.TWILIO_API_SECRET, {
  accountSid: process.env.TWILIO_ACCOUNT_SID,
});

async function findNumbers() {
  const local = await client.availablePhoneNumbers("CA").local.list({
    areaCode: 416,
    voiceEnabled: true,
    excludeAllAddressRequired: true,
    limit: 10,
  });
  for (const n of local) {
    console.log(n.phoneNumber, n.locality, n.region, n.rateCenter,
      n.addressRequirements, JSON.stringify(n.capabilities));
  }

  // Toll-free in the US, anchored to the 833 code
  const tollFree = await client.availablePhoneNumbers("US").tollFree.list({
    contains: "+1833",
    limit: 10,
  });
  tollFree.forEach((n) => console.log(n.phoneNumber, n.addressRequirements));
}

findNumbers();

Las mismas búsquedas con curl:

curl -G "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/AvailablePhoneNumbers/CA/Local.json" \
  --data-urlencode "AreaCode=416" \
  --data-urlencode "VoiceEnabled=true" \
  --data-urlencode "ExcludeAllAddressRequired=true" \
  --data-urlencode "PageSize=10" \
  -u "$TWILIO_API_KEY:$TWILIO_API_SECRET"

curl -G "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/AvailablePhoneNumbers/US/TollFree.json" \
  --data-urlencode "Contains=+1833" \
  --data-urlencode "PageSize=10" \
  -u "$TWILIO_API_KEY:$TWILIO_API_SECRET"

PageSize es 50 por defecto y puede llegar a 1,000.1 Es común que una búsqueda por un código de área específico no devuelva nada en zonas agotadas o con muchos códigos superpuestos; amplíe con InRegion o NearNumber en lugar de reintentar. En los números gratuitos, Twilio advierte que "often" (con frecuencia) no tiene números 1-800 en inventario "due to low availability" (por baja disponibilidad).29 Si quiere un código gratuito en particular, búsquelo antes de diseñar una marca alrededor de él.

Elegir el código de área es una decisión de negocio más que de API; nuestra referencia de códigos de área explica los códigos superpuestos y las regiones que atiende cada uno.

Compra (aprovisionamiento) del número

La compra es un POST a /2010-04-01/Accounts/{AccountSid}/IncomingPhoneNumbers.json. Debe enviar PhoneNumber en formato E.164 o AreaCode, que "Can be any three-digit, US or Canada area code" (puede ser cualquier código de área de tres dígitos de EE. UU. o Canadá) y deja que Twilio elija cualquier número disponible en él.3 Preferimos buscar siempre primero y comprar un PhoneNumber exacto: usted ve el centro de tarifas y las capacidades antes de pagar, y su código es determinista.

Defina el enrutamiento al momento de la compra para que el número nunca exista sin configurar. VoiceUrl es "The URL that we should call to answer a call to the new phone number" (la URL a la que debemos llamar para contestar una llamada al nuevo número) y se ignora si se define un VoiceApplicationSid o un TrunkSid; definir cualquiera de esos dos elimina el otro.3 SmsUrl hace lo mismo con los mensajes de texto entrantes.3 Aquí también pueden definirse los vínculos de cumplimiento: AddressSid, BundleSid y EmergencyAddressSid.3

async function buy(phoneNumber, addressSid) {
  const params = {
    phoneNumber,                                  // exact E.164 number from the search
    friendlyName: "Main line (menu)",
    voiceUrl: "https://example.com/voice/incoming",
    voiceMethod: "POST",
    smsUrl: "https://example.com/sms/incoming",
  };
  if (addressSid) params.addressSid = addressSid;  // only when address_requirements != "none"
  const pn = await client.incomingPhoneNumbers.create(params);
  console.log(pn.sid, pn.phoneNumber, pn.addressRequirements, pn.emergencyStatus);
  return pn;
}

curl -X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json" \
  --data-urlencode "PhoneNumber=+14165550123" \
  --data-urlencode "FriendlyName=Main line (menu)" \
  --data-urlencode "VoiceUrl=https://example.com/voice/incoming" \
  -u "$TWILIO_API_KEY:$TWILIO_API_SECRET"

Guarde el SID PN devuelto, no solo el número de teléfono: el SID es lo que usan todas las actualizaciones, registros y liberaciones posteriores. El Centro de ayuda de Twilio indica que el precio mensual completo se cobra al aprovisionar el número.29

Requisitos de dirección y Regulatory Bundles en EE. UU. y Canadá

La maquinaria regulatoria de Twilio existe porque, en sus palabras, "a phone number is a national resource" (un número de teléfono es un recurso nacional) y "governments want to identify the end-user of the phone number" (los gobiernos quieren identificar al usuario final del número).8 Tiene dos capas: un recurso Address que exigen algunos tipos de número y un Regulatory Bundle (identidad del usuario final más documentos de respaldo) que exigen algunos países.

Bundles: hoy no se exigen para números de EE. UU. ni de Canadá

Twilio publica un índice país por país llamado "Phone Number Regulations". El 26 de octubre de 2026 listaba 89 países, y ni Estados Unidos ni Canadá figuraban entre ellos; las URL por país que contendrían las páginas regulatorias de EE. UU. y Canadá devolvían "not found" (no encontrado).7 El parámetro BundleSid se documenta solo como necesario cuando "Some regions require a Bundle" (algunas regiones exigen un Bundle).3 En la práctica, eso significa que puede comprar números locales de EE. UU. y Canadá sin armar un bundle de identidad. Las verificaciones de identidad para estos dos países están en otro lugar: en los perfiles de Trust Hub que exigen A2P 10DLC, la verificación de números gratuitos y CNAM (más abajo).

Direcciones: revise el indicador del número

Twilio define tres requisitos de dirección. "Any" exige una dirección en cualquier parte del mundo; "Local" exige una que "corresponds to the phone number's prefix" (corresponda al prefijo del número); "Foreign" exige una fuera del país del número.5 La dirección "must be the residence or place of business of the individual or entity using the phone number" (debe ser la residencia o el lugar de negocios de la persona o entidad que usa el número), lo que para un revendedor significa la del cliente final, no la suya, y Twilio recomienda "strongly" (enfáticamente) usar subcuentas para mantener separados los números y las direcciones de los clientes.5 La validación del sistema se aplica solo a los requisitos Local; con Any, se acepta una dirección que el sistema no haya validado, aunque debe seguir siendo una dirección real.6

¿Qué tipos norteamericanos tienen un requisito? La lista de precios descargable de números de Twilio tiene una columna "Address Required". El día que la leímos mostraba Yes para los números gratuitos de EE. UU. y No para los locales de EE. UU., los locales de Canadá y los gratuitos de Canadá.9 El propio ejemplo de compra de números gratuitos de Twilio pasa un AddressSid, lo cual es coherente.29 Trate la columna de la lista de precios como una guía y el campo address_requirements del número específico como la regla.1

Crear una dirección es un POST a /Addresses.json con CustomerName, Street, City, Region, PostalCode e IsoCountry como campos obligatorios.4 Si la dirección se parece a una válida, Twilio la corrige en silencio, a menos que envíe AutoCorrectAddress=false; en ese caso recibe la sugerencia como error 21629, y una dirección que falla la validación por completo es el error 21628.4

const addr = await client.addresses.create({
  customerName: "Example Dental Ltd",
  street: "100 Example St",
  city: "Springfield",
  region: "IL",
  postalCode: "62701",
  isoCountry: "US",
  friendlyName: "HQ",
  autoCorrectAddress: false,   // see the suggestion instead of a silent rewrite
});
console.log(addr.sid, addr.validated, addr.verified);

Una sola Address puede cumplir el requisito de muchos números de la misma cuenta.4 No se puede eliminar una dirección mientras haya números que dependan de ella (Twilio devuelve el error 21625), lo cual es una protección útil y no una molestia.4

CNAM: el nombre que se muestra en sus llamadas salientes

Estados Unidos El CNAM (nombre de quien llama) solo importa para las llamadas que su número hace. Un número que solo contesta a quienes llaman a un menú no lo necesita. Si su aplicación devuelve llamadas a clientes, envía notificaciones de voz o reenvía llamadas con su número como identificador, sí lo necesita.

En Twilio, el CNAM es un registro de Trust Hub que Twilio describe como "a free way to help boost your call pickup rates" (una forma gratuita de ayudar a aumentar la tasa de respuesta a sus llamadas).14 La secuencia es: crear y obtener la aprobación de un Business Profile, asignarle sus números, crear un CNAM Trust Product con un nombre para mostrar, enviarlo a revisión y, una vez "Twilio-Approved", Twilio registra el nombre "with the CNAM authoritative databases in the United States" (en las bases de datos autorizadas de CNAM en Estados Unidos).13 Puede hacerse en la Console o mediante la API REST de Trust Hub.13

Los límites, todos de la guía de CNAM de Twilio, que califica la función como Public Beta:13

• El nombre para mostrar tiene un máximo de 15 caracteres, debe comenzar con una letra, solo puede contener letras, números, puntos, comas y espacios, y "cannot be a generic value such as a City/State" (no puede ser un valor genérico como una ciudad o estado).
• Sin un nombre registrado, lo que se muestra por defecto es la ciudad y el estado del número.
• Solo son elegibles los números long code estándar de EE. UU. ya asignados a su Business Profile. "CA numbers cannot be assigned to CNAM profiles" (los números de Canadá no pueden asignarse a perfiles CNAM), y tampoco los números gratuitos de EE. UU. ni de Canadá; el CNAM de números gratuitos se tramita por el soporte de Twilio.
• Tras la aprobación, el nombre "may take 48-72 hours to propagate to all carriers in the United States" (puede tardar de 48 a 72 horas en propagarse a todas las operadoras de Estados Unidos).
• Lo que se muestra depende de quien recibe la llamada: "For mobile phones, most US carriers offer CNAM as an opt-in feature" (en los celulares, la mayoría de las operadoras de EE. UU. ofrece el CNAM como función opcional), y "not all carriers subscribe to every CNAM database" (no todas las operadoras se suscriben a todas las bases de datos CNAM).

Nuestra opinión: registre el CNAM porque es gratis y elimina el valor por defecto de "ciudad, estado", pero no espere que arregle las tasas de respuesta en celulares, donde la visualización es opcional y el etiquetado de spam lo deciden otras señales. Las guías de voz de Twilio para EE. UU. recomiendan firmar con SHAKEN/STIR las llamadas salientes,15 y Twilio vende aparte un producto Branded Calling, con precio de $0.12 por llamada en su página de voz de EE. UU.10 Si sus llamadas salientes se etiquetan como spam, nuestro artículo sobre cómo diagnosticar una etiqueta "Spam Likely" (en inglés) explica las vías de reclamación ante las operadoras. En Canadá, las herramientas de Twilio no ofrecen ningún registro de CNAM para números locales,13 así que planee la experiencia de quien recibe la llamada sin él.

Verificación de números gratuitos, si el número va a enviar mensajes

EE. UU. y Canadá La verificación de números gratuitos es obligatoria "for sending messages over Toll-Free phone numbers to the US and Canada" (para enviar mensajes desde números gratuitos hacia EE. UU. y Canadá).22 Desde el 31 de enero de 2024, los mensajes de números gratuitos sin verificar (Restricted o Pending) se bloquean con el error 30032, y Twilio señala que esos mensajes bloqueados "are subject to messaging fees" (están sujetos a cargos de mensajería).22 Un número gratuito usado solo para voz no necesita verificación; este punto solo importa el día en que decida enviar mensajes desde él.

Lo que Twilio indica sobre el proceso:

• La solicitud se presenta en la Console o con la Messaging Compliance API; Twilio pide que "allow approximately 3-5 business days" (prevea aproximadamente de 3 a 5 días hábiles).22
• Se exigen un número de registro comercial y su autoridad emisora "for all business types except SOLE_PROPRIETOR" (para todos los tipos de negocio excepto SOLE_PROPRIETOR); entre las autoridades aceptadas están EIN, CBN y PROVINCIAL_NUMBER, de modo que las empresas de EE. UU. y de Canadá pueden usar sus propios números de registro.23
• Los números verificados reciben "3 SMS segments per second by default, but can be increased" (3 segmentos SMS por segundo por defecto, con posibilidad de aumento).22
• Los rechazos por infracciones de contenido o de política no se pueden volver a presentar; los demás rechazos se pueden corregir y volver a presentar.22
• La verificación no se transfiere. Twilio menciona ambos casos: un número movido a otra cuenta o subcuenta ("verification records cannot transfer between accounts", los registros de verificación no se transfieren entre cuentas) y un número verificado con otro proveedor antes de portarlo a Twilio ("verification records cannot transfer between providers", no se transfieren entre proveedores).22

Ese último punto es el que más sorprende. Si porta un número gratuito que hoy envía mensajes, prevea volver a verificarlo y un periodo sin mensajes salientes, y presente la verificación en cuanto el número llegue a su cuenta.

A2P 10DLC, si un número local va a enviar mensajes

Estados Unidos A2P 10DLC es "the standard that United States telecom carriers have put in place to ensure that SMS traffic to US end users through long code phone numbers is verified and consensual" (el estándar que las operadoras de telecomunicaciones de Estados Unidos han establecido para asegurar que el tráfico SMS hacia usuarios de EE. UU. mediante números long code sea verificado y consentido).16 Twilio es explícito en que las operadoras tratan todo lo que sale de un número de Twilio como de aplicación a persona: "Anyone using a 10DLC number with Twilio to send SMS messages to the US will need to register. This includes individuals and hobbyists" (cualquiera que use un número 10DLC con Twilio para enviar SMS a EE. UU. deberá registrarse, incluidos particulares y aficionados).16

El alcance depende del destino. El tráfico hacia EE. UU. comprende los mensajes salientes a Estados Unidos, Puerto Rico, las Islas Vírgenes de EE. UU., Guam y Samoa Estadounidense; el tráfico saliente hacia Canadá y los mensajes entrantes que recibe su número "not impacted" (no se ven afectados).19 Por lo tanto, una empresa canadiense que envía mensajes a clientes de EE. UU. desde un número local canadiense está dentro del esquema, y Twilio acepta un Business Number canadiense como identificador fiscal para los brands Standard y Low-Volume Standard.16 Un número sin registrar que envía a EE. UU. recibe el error 30034, y las tarifas de mensajería de Twilio se siguen aplicando.19

Qué se registra

Dos cosas: un Brand (quién envía) y una Campaign (qué envía, cómo la gente acepta, se da de baja y obtiene ayuda).16 La Campaign se asocia a un Messaging Service, que "can only be linked with one Campaign at a time" (solo puede vincularse a una Campaign a la vez) y debe tener sus números 10DLC en su grupo de remitentes; Twilio indica que agregue todos los números que piensa usar antes de enviar la solicitud, porque al aprobarse "all of the 10DLC phone numbers within the Campaign's Messaging Service are registered" (se registran todos los números 10DLC del Messaging Service de la Campaign).17 Un Brand puede tener hasta cinco Campaigns.17

El tipo de Brand fija su límite. La descripción general de Twilio da a los brands Sole Proprietor 1,000 segmentos al día hacia T-Mobile (unos 3,000 entre las operadoras de EE. UU.), a Low-Volume Standard hasta 2,000 al día hacia T-Mobile (unos 6,000 entre operadoras) y a Standard desde 2,000 en adelante según el Trust Score.16 Sole Proprietor es para quienes no tienen identificador fiscal; Standard y Low-Volume Standard lo exigen.16

Cargos, tal como Twilio los traslada

Desplace la tabla hacia los lados para ver todas las columnas.

Todas las cifras provienen del artículo de Twilio sobre cargos de A2P 10DLC, actualizado el 26 de septiembre de 2026, que también señala que TCR aumentó varios cargos el 1 de agosto de 2025 y que el cargo del brand se cobra al crearlo "and your Brand may still be in an unverified state" (y es posible que su Brand todavía esté sin verificar).18 Además, cada operadora de EE. UU. cobra un cargo por segmento. En la página de precios de SMS de EE. UU. de Twilio, el SMS saliente por long code lleva $0.0035 de AT&T, $0.0045 de T-Mobile y $0.005 de Verizon, sobre la base de $0.0083 por segmento.12 Las guías de SMS de EE. UU. de Twilio agregan sanciones fáciles de pasar por alto: T-Mobile traslada un cargo de $1,000 por "10DLC Long Code Messaging Program Evasion" (evasión del programa de mensajería 10DLC por long code), como el snowshoeing, y, tras una advertencia previa, "a $10,000 pass-through fee" (un cargo trasladado de $10,000) por cada infracción de contenido de su Código de Conducta.20

Planifique el tiempo además del dinero. La guía de registro de Twilio dice que las revisiones manuales de brand "take seven business days or more" (tardan siete días hábiles o más) y, el día que la leímos, que las revisiones de campañas "are currently taking 10–15 days" (actualmente tardan de 10 a 15 días); en otro punto de la misma guía dice que la verificación "can take between two to three weeks" (puede tardar de dos a tres semanas).17 Nosotros planearíamos tres semanas y nos alegraríamos si es menos.

Canadá

Canadá En la guía de Twilio no hay un equivalente canadiense del registro 10DLC. Lo que Twilio sí dice es que "Canadian mobile carriers enforce strict filtering on A2P messages" (las operadoras móviles canadienses aplican un filtrado estricto a los mensajes A2P) y recomienda short codes o números gratuitos verificados "for optimal delivery results" (para obtener resultados óptimos de entrega).21 Los short codes canadienses indican un tiempo de aprovisionamiento de 12 a 16 semanas.21 Nuestra opinión: para una empresa que envía mensajes sobre todo a clientes canadienses, un número gratuito verificado es la vía realista; para un público mixto de EE. UU. y Canadá, el mismo número gratuito verificado cubre ambos países con un solo proceso.22

Antes de todo esto, pregúntese si realmente necesita enviar mensajes de texto. Si el único plan es un mensaje automático tras una llamada perdida, nuestro artículo sobre el mensaje de texto automático (en inglés) explica las reglas de consentimiento junto con el trabajo de registro.

Portación de un número existente a Twilio

Las reglas que rigen la portación entre operadoras se explican en nuestra guía de portación. Esta sección trata del proceso propio de Twilio, que difiere entre los dos países más de lo que la mayoría espera.

Estados Unidos

Twilio indica que los números locales (celulares, VoIP, fijos) y los gratuitos son portables, con la salvedad de que "In rare cases, Twilio may not have geographic coverage for that number" (en casos poco frecuentes, Twilio puede no tener cobertura geográfica para ese número).24 Se requiere: una Letter of Authorization (LOA), el nombre y la dirección que coincidan con el Customer Service Record (CSR) de la operadora que se pierde, una factura telefónica de los últimos 30 días, el número de cuenta actual y un PIN si la operadora lo usa.24 El plazo que indica Twilio es "5 to 15 days for standard ports" (de 5 a 15 días para portaciones estándar) y "up to 4 weeks or longer barring rejections" (hasta 4 semanas o más si no hay rechazos), con 4 a 6 semanas para portaciones masivas de más de 50 números, y un máximo de 1,000 números por portación.24

La línea más útil de esa página: "The most common reason for a rejected port is incorrect name and/or address information" (el motivo más común de rechazo es información incorrecta de nombre o dirección), y la solución es pedir a su proveedor actual el nombre y la dirección que figuran en su CSR.24 La dirección de su factura no siempre es la del CSR.

Para los números locales y celulares de EE. UU. también existe una Porting API, en Public Beta al momento de escribir esto.27 Acepta hasta 1,000 números de EE. UU. que no sean gratuitos por solicitud, exige subir primero una factura de servicios mediante la Documents API y no admite números gratuitos.28 Twilio genera una LOA electrónica y la envía por correo electrónico al representante autorizado, que "has 30 days to sign this document or the port-in request will be canceled automatically" (tiene 30 días para firmar este documento o la solicitud de portación se cancelará automáticamente).27 La target_port_in_date "must be at least 7 days in the future for US ports" (debe ser al menos 7 días en el futuro para portaciones de EE. UU.), y Twilio no puede garantizar que la operadora que se pierde la respete.28 Use primero la verificación de portabilidad; es un seguro barato contra una solicitud que fracasa por un número que Twilio no puede atender.27

Los números gratuitos de EE. UU. se mueven cambiando el RespOrg. El artículo de Twilio sobre números gratuitos señala que algunos proveedores ofrecen una opción más rápida de "Transfer to RespOrg" e indica que el RespOrg ID de Twilio es TWI01.29 Nuestra guía de números gratuitos explica qué es un RespOrg.

Canadá

Canadá Twilio porta números locales, celulares y gratuitos de Canadá,25 pero la mecánica es distinta:

• Dónde se presenta. Las portaciones de números gratuitos de Canadá se hacen en la Twilio Console; las de números locales y celulares usan un formulario de portación aparte, no la Console ni la Porting API.25
• Papeleo. La plantilla de LOA canadiense de Twilio, una copia de la factura más reciente, el número de cuenta y un PIN si se requiere. La página de guías dice que la LOA debe tener fecha de los últimos 30 días;25 el artículo del Centro de ayuda lo reduce a 15 días para números gratuitos.26 La dirección de servicio debe ser una dirección física, no un apartado postal.26
• La rareza de la dirección. Para números gratuitos de Canadá, la herramienta de Twilio "only accepts American service addresses" (solo acepta direcciones de servicio estadounidenses), así que su artículo de ayuda indica ingresar una dirección de EE. UU. en la herramienta mientras que la LOA misma "must show your actual Canadian service address" (debe mostrar su dirección de servicio canadiense real), porque eso es lo que verifica el proveedor que se pierde.26
• El mensaje de 90 minutos. "You will need to approve the port within a 90-minute timeframe from receiving the port approval SMS text from the losing provider" (deberá aprobar la portación dentro de los 90 minutos posteriores a recibir el SMS de aprobación del proveedor que se pierde), o la portación se rechaza.2526 Asegúrese de que quien tiene la línea sepa que el mensaje llegará y qué significa.
• Los plazos no coinciden. La página de guías dice de 5 a 7 días hábiles tras la documentación completa;25 el artículo de ayuda indica "up to 4 weeks" (hasta 4 semanas) para cada tipo de número.26 Daríamos la cifra más larga a quien dependa de la fecha.
• Rechazos frecuentes: una LOA firmada por alguien que no es el usuario autorizado, una dirección del sitio que no coincide con los registros del proveedor que se pierde y un número que forma parte de un rango mayor que debe portarse junto o dividirse primero.26

En ambos países: antes y después de la fecha de portación

El proceso canadiense de Twilio dice "do not close your account with your service provider and keep your numbers active" (no cierre su cuenta con su proveedor de servicio y mantenga activos sus números) mientras la portación está en curso, y que "It is critical to configure your number prior to the porting date" (es fundamental configurar su número antes de la fecha de portación).26 Ambas indicaciones valen igual en EE. UU. Un número portado llega sin ninguno de los registros que tenía con el proveedor anterior: la guía de portación de Twilio dice que hay que "fulfill all messaging and voice compliance requirements" (cumplir todos los requisitos de cumplimiento de mensajería y voz) antes de usarlo,27 y los registros de verificación de números gratuitos explícitamente no se transfieren entre proveedores.22 Ponga la asignación a la campaña 10DLC, la verificación de números gratuitos, el CNAM y la dirección de emergencia en el plan de trabajo de la portación, no después.

Direcciones de emergencia, si el número hace llamadas

Una dirección de emergencia importa cuando el número se usa para hacer llamadas: un teléfono de escritorio SIP, un softphone, un marcador en el navegador. Un número que solo recibe llamadas hacia un menú nunca origina una llamada al 911. Nuestra guía de llamadas de emergencia explica el aspecto legal (Kari's Law, RAY BAUM'S Act y las reglas 9-1-1 de la CRTC); esta sección trata de la mecánica en Twilio.

Twilio admite el registro de direcciones de emergencia en solo tres países: "Currently only US, Canada and UK are enabled for emergency address registration" (actualmente solo EE. UU., Canadá y el Reino Unido están habilitados para el registro de direcciones de emergencia).30 En EE. UU. y Canadá admite tanto E911, donde "The call automatically includes the caller's Twilio phone number and corresponding address information" (la llamada incluye automáticamente el número de Twilio de quien llama y su dirección), como Basic 911, donde el despachador no tiene ninguno de los dos a menos que quien llama los diga.30 Las llamadas desde un número sin dirección registrada se enrutan a "a national emergency location center" (un centro nacional de ubicación de emergencias), y Twilio cobra por eso.30

La dirección debe ser una que el sistema 911 reconozca: "In the US and CA, the address must be recognized by the Master Street Address Guide (MSAG) database" (en EE. UU. y Canadá, la dirección debe ser reconocida por la base de datos Master Street Address Guide), y Twilio advierte que la versión del MSAG "often differs from the equivalent US Postal Service address" (a menudo difiere de la dirección equivalente del Servicio Postal de EE. UU.).30 El artículo de ayuda de Twilio agrega reglas prácticas que ahorran un tique de soporte: sin ZIP+4 (solo cinco dígitos), abreviaturas estándar sin puntuación, códigos de estado de dos letras, sin símbolos como & o # en los campos de nombre y dirección, un límite de 32 caracteres para los nombres de empresa y descriptivos, y nunca un apartado postal.31 El límite de FriendlyName para direcciones de emergencia es igualmente de 32 caracteres.4

Con la API, cree una Address con EmergencyEnabled activado,4 asóciela al número como EmergencyAddressSid y consulte emergency_address_status hasta que diga registered (otros valores son pending-registration y registration-failure).3

const e = await client.addresses.create({
  customerName: "Example Dental Ltd",
  street: "100 Example St",
  city: "Springfield",
  region: "IL",
  postalCode: "62701",          // 5 digits, not ZIP+4
  isoCountry: "US",
  friendlyName: "HQ floor 2",   // 32 characters max for emergency addresses
  emergencyEnabled: true,
});

await client.incomingPhoneNumbers("PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
  .update({ emergencyAddressSid: e.sid });

const pn = await client.incomingPhoneNumbers("PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX").fetch();
console.log(pn.emergencyAddressStatus, pn.emergencyStatus);

Dos detalles operativos. Para cambiar una dirección, se desasocia la anterior, se confirma que el estado indique no registrada y luego se asocia la nueva; Twilio indica "Allow 30 minutes between disassociation and re-association" (deje 30 minutos entre la desasociación y la nueva asociación) en EE. UU. y Canadá.30 Y una dirección de emergencia registrada debe quitarse antes de poder liberar el número.32 Twilio también exige que las llamadas de emergencia se hagan a un número de emergencia válido "from the same country as the From phone number" (del mismo país que el número From) y que el webhook del número esté configurado "in case the emergency responder needs to call you back" (por si el servicio de emergencia necesita devolver la llamada).30

Cuánto cuestan los números (EE. UU. y Canadá)

Los precios de lista de Twilio, con las fechas que las propias páginas indican. Existen descuentos por volumen y precios por uso comprometido que no se muestran. Los impuestos y cualquier recargo regulatorio en su factura quedan fuera del alcance de esta página.

Desplace la tabla hacia los lados para ver todas las columnas.

Las páginas de voz de EE. UU. y de Canadá indican ambas "Pricing current as of August 2026"; la de SMS de EE. UU. indica octubre de 2026.101112 No verificamos los precios de SMS de Canadá para esta página, por lo que figuran como tales en lugar de suponerlos iguales. Hay algunas excepciones dentro de la tarifa saliente de "EE. UU. y Canadá" en las tablas de Twilio: las llamadas a Alaska figuran a $0.0945 por minuto y al Yukón a $0.1525.1011

Un ejemplo para un menú que solo contesta llamadas: un número local que recibe 600 minutos de llamadas entrantes en un mes cuesta $1.15 + 600 × $0.0085 = $6.25. El mismo tráfico en un número gratuito cuesta $2.15 + 600 × $0.0220 = $15.35. Reenviar esas llamadas a los celulares del personal agrega minutos salientes a $0.0140 por cada tramo reenviado. Nada de esto incluye los cargos de registro anteriores, que solo aplican cuando envía mensajes o le pone marca a las llamadas salientes.

Cómo liberar un número sin arrepentirse

Liberar es un DELETE sobre el IncomingPhoneNumber. La referencia de la API de Twilio dice que "releases it from your account. Twilio will no longer answer calls to this number and will stop charging the monthly fee" (lo libera de su cuenta; Twilio dejará de contestar las llamadas a este número y dejará de cobrar la tarifa mensual), y advierte: "Twilio might reclaim and assign the number to another customer, so delete numbers with caution." (Twilio podría recuperar el número y asignarlo a otro cliente, así que elimine números con precaución).3

// Node.js
await client.incomingPhoneNumbers("PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX").remove();

# curl
curl -X DELETE "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers/PNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json" \
  -u "$TWILIO_API_KEY:$TWILIO_API_SECRET"

Lo que ocurre después, según el Centro de ayuda de Twilio: el número queda reservado para su cuenta durante 10 días, tras lo cual pasa a pruebas y reciclaje antes de ofrecerse a otra persona.33 Dentro de esos 10 días puede volver a comprarlo desde la página Released Numbers, pero la facturación se reinicia y "the restored phone number will be given a new Phone Number Sid" (al número restaurado se le asignará un nuevo Phone Number Sid), por lo que todo lo que dependa del SID anterior deja de funcionar.33 Pasados los 10 días, la única vía es una solicitud a soporte.33

Una lista de verificación para liberar que seguiríamos (nuestra opinión, basada en los puntos anteriores):

1. Busque el número en todos los lugares donde esté publicado: sitio web, letreros, directorios, facturas, firmas de correo electrónico. Si está impreso en algún lugar que usted no controla, siga pagando $1.15 al mes durante un periodo de reenvío.
2. Si otra persona va a necesitar el número, pórtelo a otro proveedor en lugar de liberarlo. Un número liberado se pierde una vez que pasan los 10 días.
3. Primero anule el registro de la dirección de emergencia; Twilio no libera un número que todavía tenga una.32
4. Quítelo de cualquier Messaging Service y campaña a la que pertenezca, para que sus registros describan los números que realmente usa.
5. Libere por SID desde código que registre lo que liberó, y conserve ese registro al menos durante la ventana de 10 días.

La lista de verificación: qué hacer y cuándo importa

Desplace la tabla hacia los lados para ver todas las columnas.

Ninguna de estas obligaciones es exclusiva de Twilio. El 10DLC y la verificación de números gratuitos son esquemas de las operadoras, que el artículo de Twilio sobre números gratuitos ubica dentro de "industry-wide, global moves to require registration for all A2P messaging traffic" (movimientos globales de toda la industria para exigir registro de todo el tráfico de mensajería A2P),22 y las reglas de las direcciones de emergencia vienen de los reguladores, así que otro proveedor de CPaaS cambia las llamadas a la API, no la lista. Lo que sí varía según el proveedor son las herramientas, los precios y el soporte para los casos de Canadá, algo que conviene comparar antes de comprometer un gran inventario de números en una sola cuenta. Si prefiere no llevar esta lista, un menú telefónico administrado es la otra vía: el nuestro es uno, y el resto de las guías de Twilio muestra lo que implica construirlo usted mismo.