Administrar números de teléfono de empresa

En esta guía se proporciona información general relacionada con los números de teléfono de socios de soluciones y clientes. Además, esta guía incluye información del proceso que deben llevar a cabo los socios de soluciones en caso de tener que administrar el número de teléfono y los certificados de un cliente.

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

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

Las empresas necesitan un número dedicado para utilizar WhatsApp en el registro insertado. Si una empresa tiene un número registrado activamente en WhatsApp Messenger o en la aplicación de WhatsApp Business, no puede utilizar el mismo número de teléfono.

Las empresas pueden tener varios números de teléfono asociados con su cuenta empresarial de Meta, así que solo tienen que añadir otro número de teléfono y utilizarlo para WhatsApp.

Una empresa no puede registrarse mediante el proceso de registro insertado con un número de teléfono que ya se ha registrado con las versiones de la aplicación de consumidor o Business de WhatsApp.

Para obtener información más detallada sobre 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 de WhatsApp registrado, consulta Migrar un número de teléfono.

Instrucciones para clientes empresariales

Esta sección está dirigida a clientes del registro insertado y proporciona instrucciones sobre las acciones que pueden llevar a cabo en relación con los números de teléfono.

Añadir números de teléfono a una cuenta de WhatsApp Business

Existen dos métodos para añadir más números a una cuenta de WhatsApp Business (WABA):

[Recomendado] Vuelve a seguir el proceso de registro insertado, selecciona el Business Manager y la cuenta WABA existentes, añade el número y verifícalo.
En Business Manager, dirígete a la pestaña Números de teléfono del Administrador de WhatsApp y selecciona Añadir número de teléfono. En caso de utilizar esta opción, el socio de soluciones tiene que verificar manualmente el número de teléfono, ya que la verificación del teléfono no está disponible en Business Manager. Por este motivo, se recomienda que las empresas sigan el flujo de registro insertado para añadir más números.

Instrucciones para socios de soluciones

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

Obtener los números de teléfono

Utiliza el extremo GET /<WABA_ID>/phone_numbers para obtener una lista con los números de teléfono de empresa de la cuenta WABA de un cliente empresarial.

Solicitud

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

Respuesta

Si se realiza correctamente:

{ "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 nube

Después de una verificación de teléfono correcta del proceso de registro insertado, el registro debería completarse correctamente con una llamada de API al extremo register. Para ello, proporciona cualquier opción de code_method (sms | voice). Dado que el número de teléfono ya está verificado, no es necesario que te preocupes por el código de registro. La llamada a la API verify no es necesaria.

Como alternativa, puedes verificar previamente los números de teléfono y ofrecérselos a tus clientes en el nuevo proceso de registro insertado. De esta forma, evitas que los clientes tengan que ponerse en contacto contigo para obtener una contraseña de un solo uso durante el proceso de incorporación. Puedes consultar Números de teléfono verificados previamente.

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

Después de una verificación de teléfono correcta del proceso de registro insertado, el registro debería completarse correctamente con una llamada de API al extremo account. Para ello, proporciona cualquier opción de code_method (sms | voice). Dado que el número de teléfono ya está verificado, no es necesario que te preocupes por el código de registro. La llamada a la API verify no es necesaria.

Un número de teléfono debe registrarse como máximo 14 días después de someterse al proceso de registro insertado. Si un número no se registra durante ese periodo, el teléfono debe volver a someterse al proceso de registro insertado antes de registrarse.

Obtener el estado y el certificado del teléfono

El extremo 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 un cambio de nombre. Consulta Leer números de teléfono para obtener más información.

Ejemplo de solicitud

En el ejemplo siguiente, usa el identificador de la cuenta 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 una cuenta de WhatsApp Business, ve a Business Manager > Configuración de la empresa > Cuentas > Cuentas de WhatsApp Business. Busca la cuenta que quieras usar y haz clic en ella. Se abrirá una ventana con información acerca de la cuenta, como 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 la respuesta

Nombre	Descripción
`name_status`	Estado de revisión de la solicitud de nombre para mostrar actual. Haz clic en la flecha de la columna de la izquierda para consultar las opciones disponibles.
Opciones disponibles	`APPROVED`: el nombre se ha aprobado. Ya puedes descargar el certificado. `DECLINED`: el nombre no se ha aprobado. No puedes descargar el certificado. `EXPIRED`: el certificado ha caducado y ya no se puede descargar. `PENDING_REVIEW`: la solicitud de nombre está en proceso de revisión. No puedes descargar el certificado. `NONE`: no hay ningún certificado disponible.
`new_name_status`	Estado de revisión de una solicitud de cambio de nombre para mostrar. Este campo solo devuelve datos si se ha solicitado un cambio de nombre para mostrar.
`certificate`	Devuelve el certificado actual para el número de teléfono en cuestión.
`new_certificate`	Certificado de un nuevo nombre para mostrar, que se emite después de la aprobación de un cambio de nombre para mostrar. Este campo solo devuelve datos si una solicitud de cambio de nombre para mostrar se ha aprobado y está disponible hasta que el número de teléfono se registra con el nuevo certificado.

Obtener el estado de la OTP del teléfono

Para ver si un número de teléfono se ha verificado mediante una OTP (contraseña de un solo uso), consulta el campo code_verification_status del número. En primer lugar, realiza una llamada GET al extremo /{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 incluirá el elemento code_verification_status con una de las opciones siguientes: VERIFIED o NOT_VERIFIED. Una respuesta de ejemplo tendría el aspecto siguiente:

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

También puedes llamar al identificador del número de teléfono para obtener el estado:

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

Para obtener el identificador de un número de teléfono, llama a https://graph.facebook.com/v21.0/{whatsapp-business-account-ID}/phone_numbers. Sustituye {whatsapp-business-account-ID} por el identificador de la cuenta de WhatsApp Business a la que pertenece el número de teléfono. Consulta un ejemplo en Obtener todos los números de teléfono.

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

Puedes consultar números de teléfono y filtrarlos por la opción account_mode. Para la solicitud, puedes utilizar los parámetros que se indican a continuación.

Parámetros de la solicitud

Nombre	Descripción
`field`	Contiene el campo que se está utilizando para la filtración. En este ejemplo, debes utilizar la opción `account_mode`.
`operator`	Contiene la opción que has elegido para filtrar las cuentas. En este ejemplo, debes utilizar `EQUAL`.
`value`	Contiene el modo de cuenta que estás buscando. Haz clic en la flecha de la columna de la izquierda para consultar los valores admitidos.
Valores admitidos	`SANDBOX`: la cuenta no se ha verificado. `LIVE`: la cuenta no es apta para la experiencia de prueba no verificada o se ha actualizado a una cuenta verificada.

Ejemplo de solicitud

En el ejemplo siguiente, usa el identificador de la cuenta 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"
	}
   }
}

Administrar números de teléfono de empresa

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

Instrucciones para clientes empresariales

Añadir números de teléfono a una cuenta de WhatsApp Business

Instrucciones para socios de soluciones

Obtener los números de teléfono

Solicitud

Respuesta

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

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

Obtener el estado y el certificado del teléfono

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros de la respuesta

Obtener el estado de la OTP del teléfono

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

Parámetros de la solicitud

Ejemplo de solicitud

Ejemplo de respuesta

Más información