Registro
Para usar el número de teléfono de tu empresa con la API de nube debes registrarlo. Registra el número de teléfono de empresa en las siguientes situaciones:
- Creación de la cuenta: al implementar esta API, debes registrar el número de teléfono de empresa que quieras usar para enviar mensajes. Es necesario establecer la verificación en dos pasos durante la creación de la cuenta para añadir una capa adicional de seguridad a las cuentas.
- Cambio de nombre: en este caso, el teléfono ya está registrado y quieres cambiar el nombre para mostrar. Para ello, primero debes registrar un cambio de nombre en el Administrador de WhatsApp. Una vez aprobado el nombre, tienes que volver a registrar el teléfono con el nuevo nombre.
- Migración del número de la API local a la API de nube. Consulta Excepción de migración.
Para poder registrar el número de teléfono de empresa, primero debes verificar su propiedad.
Excepción de migración
Si migras un número de teléfono desde la API local a la API de la nube, debes realizar algunos pasos adicionales antes de registrar un número de teléfono en la API de la nube. Consulta el tema sobre la migración entre la API local y la API de la nube para ver todo el proceso.
Registrar un número de teléfono de empresa
Para registrar el número de teléfono de tu empresa verificada, realiza una llamada POST a PHONE_NUMBER_ID/register. Incluye los parámetros que se indican a continuación.
| Extremo | Autenticación |
|---|---|
|
Solution Partners must authenticate themselves with an access token with the |
Limitaciones
Las solicitudes al extremo de registro están limitadas a diez solicitudes por número de empresa en un intervalo periódico de 72 horas.
Cuando hagas una solicitud de registro, comprobaremos cuántas solicitudes de registro has hecho para registrar ese número en las últimas 72 horas. Si ya has hecho diez solicitudes, la API te devolverá el código de error 133016 y se impedirá que el número se registre durante las siguientes 72 horas.
Parámetros
| Nombre | Descripción |
|---|---|
| Obligatorio. Servicio de mensajes que se utiliza. Establece el valor en |
| Obligatorio. Si el número de teléfono de la empresa verificada ya tiene activada la verificación en dos pasos, establece este valor en el PIN de seis dígitos de la verificación en dos pasos del número. Si no recuerdas el PIN, puedes actualizarlo. Si el número de teléfono de la empresa verificada no tiene activada la verificación en dos pasos, establece este valor en un número de seis dígitos. Este número será el nuevo PIN de la verificación en dos pasos del número de teléfono de la empresa verificada. |
| Opcional. Si se incluye, activa el almacenamiento local en el número de teléfono de la empresa. El valor debe ser un código de país de dos letras en formato ISO 3166 (p. ej., Valores admitidos: Asia-Pacífico
Europa
Latinoamérica
Oriente Medio y África
Norteamérica
Cuando se activa, no se puede desactivar ni cambiar directamente. Por el contrario, debes anular el registro del número y volver a registrarlo sin este parámetro (para desactivarlo) o incluir el parámetro con el nuevo código de país (para cambiarlo). Para activar el almacenamiento local en un número que ya se ha registrado, debes anular el registro, volver a registrarlo 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 de empresa
Al anular el registro de un número de teléfono de empresa, no se puede volver a usar con la API de nube y se desactiva el almacenamiento local en dicho número si se había activado.
La anulación del registro no elimina un número ni su historial de mensajes. Para eliminar un número y su historial, consulta Eliminar un número de teléfono de una cuenta WABA.
Para anular el registro de un número de teléfono de empresa, realiza una llamada POST a PHONE_NUMBER_ID/deregister:
| Extremo | Autenticación |
|---|---|
|
Solution Partners must authenticate themselves with an access token with the |
Limitaciones
Las solicitudes al extremo de cancelación de registro están limitadas a diez solicitudes por número de empresa en un intervalo periódico de 72 horas.
Cuando hagas una solicitud de cancelación de registro, comprobaremos cuántas solicitudes de cancelación de registro has hecho para cancelar el registro de ese número en las últimas 72 horas. Si ya has hecho diez solicitudes, la API devolverá el código de error 133016 y se impedirá que el registro del número se cancele durante las siguientes 72 horas.
Ejemplo
Ejemplo de solicitud:
curl -X POST \
'https://graph.facebook.com/v21.0/FROM_PHONE_NUMBER_ID/deregister' \
-H 'Authorization: Bearer ACCESS_TOKEN'
Las respuestas que se completan correctamente tienen este aspecto:
{
"success": true
}