Registro
Para usar tu número de teléfono comercial con la API Cloud, debes registrarlo. Tendrás que registrar tu número de teléfono comercial en los siguientes casos:
- Al crear una cuenta: cuando implementes esta API, deberás registrar el número de teléfono comercial que desees usar para enviar mensajes. Exigimos la verificación en dos pasos durante la creación de cuentas para agregar una capa más de seguridad a tus cuentas.
- Al cambiar el nombre: en este caso, tu teléfono ya estará registrado y querrás cambiar tu nombre para mostrar. Para hacerlo, primero debes solicitar un cambio de nombre en el administrador de WhatsApp. Una vez aprobado el nombre, deberás registrar tu teléfono de nuevo con ese nombre.
- Al migrar tu número de la API de instalaciones locales a la API de Cloud. Consulta Excepción de migración.
Para poder registrar tu número de teléfono comercial, primero debes verificar su titularidad.
Excepción de migración
Si migras un número de teléfono de la API de instalaciones locales a la API Cloud, existen pasos extra que debes realizar antes de registrar un número de teléfono en la API Cloud. Consulta Migración entre la API de instalaciones locales y la API Cloud para obtener información sobre el proceso completo.
Registrar un número de teléfono comercial
Para registrar tu número de teléfono comercial verificado, haz una llamada POST a PHONE_NUMBER_ID/register. Incluye los parámetros que se muestran a continuación.
| Punto de conexión | Autenticación |
|---|---|
|
Solution Partners must authenticate themselves with an access token with the |
Limitaciones
Las solicitudes al punto de conexión de registro se limitan a 10 por número comercial en un intervalo de uso de 72 horas.
Cuando hagas una solicitud de registro, comprobaremos cuántas solicitudes de registro hiciste para registrar ese número en las últimas 72 horas. Si ya hiciste 10 solicitudes, la API devolverá el código de error 133016 y se impedirá que el número se registre durante las 72 horas siguientes.
Parámetros
| Nombre | Descripción |
|---|---|
| Obligatorio. Servicio de mensajería utilizado. Fija esto en |
| Obligatorio. Si ya está habilitada la verificación en dos pasos para tu número de teléfono comercial verificado, fija este valor en el PIN de verificación en dos pasos de 6 dígitos de tu número. Si no recuerdas tu PIN, podrás actualizarlo. Si no está habilitada la verificación en dos pasos para tu número de teléfono comercial verificado, fija este valor en un número de 6 dígitos. Este será el PIN de verificación en dos pasos del nuevo número de teléfono comercial verificado. |
| Opcional. Si está incluido, habilita almacenaje local en el número de teléfono de la empresa. El valor debe ser un código de país ISO 3166 de 2 letras (p. ej., Valores admitidos: APAC
Europa
Latinoamérica
MEA
Norteamérica
Una vez activado, no se puede desactivar ni cambiar directamente. En su lugar, debes eliminar el registro del número y registrarlo de nuevo sin este parámetro (para desactivar) o incluir el parámetro con el nuevo código de país (para cambiar). Para activar el almacenamiento local en un número que ya se registró, debes eliminar el registro del número, luego registrarlo de nuevo e incluir este parámetro. |
Ejemplo de solicitud sin almacenamiento local
curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834"
}
Ejemplo de solicitud con almacenamiento local
curl 'https://graph.facebook.com/v21.0/106540352242922/register ' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
"messaging_product": "whatsapp",
"pin": "212834",
"data_localization_region": "CH"
}
All API calls require authentication with access tokens.
Developers can authenticate their API calls with the access token generated in the App Dashboard > WhatsApp > API Setup.
Solution Partners must authenticate themselves with an access token with the whatsapp_business_messaging and whatsapp_business_management permissions. See System User Access Tokens for information.
Anular el registro de un número de teléfono comercial
La eliminación del registro del número de teléfono de una empresa hace que ya no se pueda utilizar con la API de la nube y desactiva el almacenaje local en el número, si se hubiera activado.
La eliminación de registro no borra un número ni su historial de mensajes. Para borrar un número y su historial, consulta Eliminar un número de teléfono de una WABA.
Para anular el registro de un número de teléfono comercial, haz una llamada POST a PHONE_NUMBER_ID/deregister:
| Punto de conexión | Autenticación |
|---|---|
|
Solution Partners must authenticate themselves with an access token with the |
Limitaciones
Las solicitudes al punto de conexión de cancelación de registro se limitan a 10 solicitudes por número comercial en un intervalo de uso de 72 horas.
Cuando hagas una solicitud de cancelación de registro, comprobaremos cuántas solicitudes hiciste para cancelar ese número en las últimas 72 horas. Si ya hiciste 10 solicitudes, la API devolverá el código de error 133016 y se evitará que el número se cancele durante las 72 horas siguientes.
Ejemplo
Solicitud de muestra:
curl -X POST \
'https://graph.facebook.com/v21.0/FROM_PHONE_NUMBER_ID/deregister' \
-H 'Authorization: Bearer ACCESS_TOKEN'
Una respuesta correcta tiene este aspecto:
{
"success": true
}