Se actualizó este documento.
La traducción en español no está disponible todavía.

Actualización del documento en inglés: Ayer

Administrar números de teléfono comerciales

En esta guía, se brinda información resumida en relación con los números de teléfono para los socios de soluciones y clientes. También contiene información sobre el proceso para los socios de soluciones en el caso de que deban administrar el número de teléfono o los certificados de un cliente.

Información preliminar sobre los números de teléfono

Existen algunos detalles que deben conocer las empresas en relación con los números de teléfono y el registro insertado.

Las empresas deben contar con un número específico para usar WhatsApp a través del registro insertado. Si una empresa tiene un número que está registrado como activo en WhatsApp Messenger o en la app de WhatsApp Business, no se podrá usar el mismo número de teléfono.

Las empresas pueden contar con varios números de teléfono asociados a sus cuentas comerciales de Meta, por lo que lo único que deberán hacer es agregar otro número de teléfono y usarlo en WhatsApp.

Ninguna empresa podrá registrarse mediante el proceso de registro insertado si el número de teléfono ya está registrado en la versión de WhatsApp Business o la destinada a consumidores.

Para obtener información detallada en relación con los números de teléfono y la Plataforma de WhatsApp Business, consulta Números de teléfono.

Para obtener información sobre cómo migrar un número de teléfono existente registrado en WhatsApp, consulta Migrar un número de teléfono.

Instrucciones para clientes comerciales

Esta sección está dedicada a los clientes del registro insertado y brinda asesoramiento respecto de las acciones que pueden realizar en relación con los números de teléfono.

Incorporar números de teléfono a la cuenta de WhatsApp Business

Existen dos maneras de agregar números adicionales a una cuenta de WhatsApp Business (WABA):

[Recomendado] Vuelve a realizar el proceso de registro insertado, selecciona el administrador comercial y la WABA, agrega el número y realiza la verificación.
En el administrador comercial, ve a la pestaña Números de teléfono del Administrador de WhatsApp y selecciona Agregar número de teléfono. Al usar esta opción, el socio de soluciones debe verificar de manera manual el número de teléfono, ya que no es posible verificar el teléfono en el administrador comercial. Por este motivo, se recomienda que las empresas sigan el proceso de registro insertado para agregar números adicionales.

Instrucciones para socios de soluciones

Esta sección está dedicada a los socios de soluciones y proporciona instrucciones para administrar los certificados y los números de teléfono de los clientes.

Obtener números de teléfono

Usa el punto de conexión GET /<WABA_ID>/phone_numbers para obtener una lista de los números de teléfono comerciales de la WABA de un cliente comercial.

Solicitud

curl 'https://graph.facebook.com/<API_VERSION>/<CUSTOMER_WABA_ID>/phone_numbers' \ -H 'Authorization: Bearer <CUSTOMER_BUSINESS_TOKEN>'

Respuesta

En caso de éxito:

{ "data": [ { "verified_name": "<VERIFIED_DISPLAY_NAME>", "code_verification_status": "<VERIFICATION_STATUS>", "display_phone_number": "<DISPLAY_PHONE_NUMBER>", "quality_rating": "<QUALITY_RATING>", "platform_type": "CLOUD_API", "throughput": { "level": "<THROUGHPUT_LEVEL>" }, "webhook_configuration": { "application": "<WEBHOOK_CALLBACK_URL>" }, "id": "<BUSINESS_PHONE_NUMBER_ID>" } ], "paging": { "cursors": { "before": "<BEFORE_CURSOR>", "after": "<AFTER_CURSOR>" } } }

Registrar números de teléfono para la API de la nube

Después de haber verificado correctamente el número en el proceso de registro insertado, si haces una llamada de la API al punto de conexión register, el registro debería resultar satisfactorio. Para hacerlo, proporciona cualquier code_method (sms | voice). Como el número de teléfono ya se verificó, no es necesario que te preocupes por el código de registro. No es obligatoria la llamada a la API verify.

Como alternativa, puedes verificar previamente números de teléfono y ofrecerlos a tus clientes en el nuevo proceso de registro insertado. Esto evita que los clientes deban comunicarse contigo para obtener una contraseña de un solo uso durante el proceso de incorporación. Consulta Números de teléfono verificados previamente.

Registrar números de teléfono para instalaciones locales

Después de haber verificado correctamente el número en el proceso de registro insertado, si haces una llamada de la API al punto de conexión account, el registro debería resultar satisfactorio. Para hacerlo, proporciona cualquier code_method (sms | voice). Como el número de teléfono ya se verificó, no es necesario que te preocupes por el código de registro. No es obligatoria la llamada a la API verify.

Los números de teléfono deben registrarse hasta 14 días después de haber realizado el flujo del registro insertado. Si un número no se registra durante este período, el teléfono debe realizar el flujo del registro insertado nuevamente antes de su registro.

Obtener el estado y el certificado del teléfono

El punto de conexión phone_numbers te permite ver el estado del nombre para mostrar de un número de teléfono y recuperar el certificado después de efectuar un cambio de nombre. Consulta Leer números de teléfono para obtener más información.

Ejemplo de solicitud

En el siguiente ejemplo, usa el identificador de la WABA asignada.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?fields=
    display_phone_number,
    certificate,
    name_status,
    new_certificate,
    new_name_status
  &access_token={system-user-access-token}"

Para encontrar el identificador de la cuenta de WhatsApp Business, ve al administrador comercial > Configuración del negocio > Cuentas > Cuentas de WhatsApp Business. Busca la cuenta que deseas usar y haz clic en ella. Se abre un panel con información de la cuenta, incluido el identificador.

Ejemplo de respuesta

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "last_onboarded_time": "2023-08-22T19:05:53+0000",
      "certificate": "AbCdEfGhIjKlMnOpQrStUvWxYz",
      "new_certificate": "123AbCdEfGhIjKlMnOpQrStUvWxYz",
      "name_status": "APPROVED",
      "new_name_status": "APPROVED",
    }
  ]
}

Parámetros de respuesta

Nombre	Descripción
`name_status`	El estado de la revisión de la solicitud actual del nombre para mostrar. Haz clic en la flecha de la columna izquierda para ver las opciones disponibles.
Opciones disponibles:	`APPROVED`: se aprobó el nombre. Puedes descargar ahora tu certificado. `DECLINED`: no se aprobó el nombre. No puedes descargar tu certificado. `EXPIRED`: tu certificado venció y ya no se puede descargar. `PENDING_REVIEW`: la solicitud del nombre está en revisión. No puedes descargar tu certificado. `NONE`: no hay ningún certificado disponible.
`new_name_status`	El estado de la revisión de la solicitud de cambio de nombre para mostrar. Este campo solo devuelve datos si se solicitó un cambio de nombre para mostrar.
`certificate`	Devuelve el certificado actual para el número de teléfono.
`new_certificate`	El certificado de un nuevo nombre para mostrar después de que se aprobó el cambio de un nombre para mostrar. Este campo solo devuelve datos si se aprobó la solicitud de cambio del nombre para mostrar y está disponible hasta que se registre el número de teléfono con el nuevo certificado.

Obtener el estado de la OTP del teléfono

Para ver si un número de teléfono se verificó mediante una contraseña de un solo uso (OTP), comprueba el campo code_verification_status del número. Primero, haz una llamada de GET al punto de conexión /{whatsapp-business-account-id}/phone_numbers:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?access_token={your-access-token}"

La respuesta incluye el estado de verificación del código con una de las siguientes opciones: VERIFIED o NOT_VERIFIED. Una respuesta de muestra tiene este aspecto:

[
  {
    "code_verification_status": "NOT_VERIFIED",
    "id": "1754951608042154"
  }
]

Como alternativa, puedes obtener el estado si haces una llamada a un identificador del número de teléfono:

curl -i -X GET \ 
"https://graph.facebook.com/v21.0/{phone-number-id}
  ?access_token={your-access-token}"

Use the WhatsApp Business Account > Phone Numbers endpoint to get a phone number's ID. See Retrieve Phone Numbers for usage details.

Filtrar números de teléfono por modo de cuenta

Puedes buscar números de teléfono y filtrarlos según su account_mode. Para la solicitud, puedes usar los parámetros que se indican a continuación.

Parámetros de la solicitud

Nombre	Descripción
`field`	Contiene el campo que se utiliza para filtrar. En este ejemplo, debes usar `account_mode`.
`operator`	Contiene el modo en que quieres filtrar las cuentas. En este ejemplo, debes usar `EQUAL`.
`value`	Contiene el modo de cuenta que buscas. Haz clic en la flecha de la columna izquierda para ver los valores admitidos.
Valores admitidos	`SANDBOX`: no se verificó la cuenta. `LIVE`: la cuenta no cumple con los requisitos de la experiencia de prueba no verificada o se actualizó a una cuenta verificada.

Ejemplo de solicitud

En el siguiente ejemplo, usa el identificador de la WABA asignada.

curl -i -X GET "https://graph.facebook.com/v21.0/{waba-id}/phone_numbers
  ?filtering=[{
    "field":"account_mode",
    "operator":"EQUAL",
    "value":"SANDBOX"}]
  &access_token={system-user-access-token}"

Ejemplo de respuesta

{
  "data": [
    {
      "id": "1972385232742141",    
      "display_phone_number": "+1 631-555-1111",
      "verified_name": "John’s Cake Shop",
      "quality_rating": "UNKNOWN",
    }
  ],
  "paging": {
	"cursors": {
		"before": "abcdefghij"
		"after": "klmnopqr"
	}
   }
}

Más información

Números de teléfono: Información general de la Plataforma de WhatsApp Business
Números de teléfono: Migrar un número registrado existente
Referencia: Cuenta de WhatsApp Business