Cuenta
/v1/account
El nodo account es para registrar tu cliente de la API de WhatsApp Business.
Ten en cuenta que la aplicación principal se reiniciará si se registra un nuevo número en un clúster que ya tiene registrado otro número.
Perímetros
Los siguientes perímetros están conectados a este nodo:
| Perímetro | Descripción |
|---|---|
Una vez que hayas recibido el código de registro mediante el método que especificaste, usa este perímetro para completar el proceso de registro de cuenta. |
Antes de empezar
Necesitarás lo siguiente:
- Tokens de autenticación que estén disponibles para el servicio de inicio de sesión
- Un número de teléfono válido asociado con tu cuenta de WhatsApp Business
- Un nombre para mostrar aprobado por WhatsApp, asociado con un número de teléfono
Copiar el certificado con codificación Base64
Se genera una cadena de certificado con codificación Base64, que se usa para la validación durante el registro del cliente de la API de WhatsApp Business.
- Ve a la configuración de la empresa en el administrador comercial de Meta.
- Haz clic en Cuentas de WhatsApp en el menú Cuentas. A continuación, selecciona tu cuenta de WhatsApp en la lista de Cuentas de WhatsApp, si aún no está resaltada.
- Ve a la pestaña Configuración y haz clic en el botón Administrador de WhatsApp.
- En la pestaña Números de teléfono, deberías ver la lista de tus números de teléfono. Haz clic en el botón Ver junto al número de teléfono cuyo certificado quieres obtener.
Obtener el certificado - En un cuadro de diálogo emergente, se mostrará la cadena de certificado dentro de un cuadro gris. Haz clic en Obtener certificado.
Descargar la cadena del certificado - Usa esta cadena de certificado en el parámetro
certal registrarte en el punto de conexiónaccount.
Consulta la documentación sobre el nombre para mostrar a fin de obtener más información.
Restricciones
- Debes usar la cuenta
adminpara registrar la app. - Si vuelves a registrar la cuenta, se debe reiniciar la aplicación principal una vez que el registro esté completo.
Solicitud
Haz una llamada POST a este punto de conexión para solicitar un código de registro. En la llamada, agrega tu número de teléfono y la cadena del certificado con codificación Base64. Puedes recibir el código por SMS o por llamada de voz.
Ejemplo:
POST /v1/account
{
"cc": "COUNTRY_CODE",
"phone_number": "PHONE_NUMBER_WITHOUT_COUNTRY_CODE",
"method": "sms" or "voice",
"cert": "VERIFIED_NAME_CERT_IN_BASE64",
"pin": "EXISTING_6_DIGIT_PIN" # required if two-step verification is enabled
}
Según la respuesta que se reciba, es posible que el procedimiento de registro se considere finalizado o que se requiera otro paso para finalizarlo. Si la operación se realiza correctamente, recibirás uno de los siguientes códigos de estado HTTP. Sigue las instrucciones que correspondan según la respuesta que recibas:
201 Created: La cuenta ya existe. Ya estás registrado, por lo que no necesitas hacer nada más.202 Accepted: La cuenta no existe. Según el método que hayas seleccionado en la solicitud, consulta tus SMS o tu número de voz para obtener el código de registro. En la respuesta, se incluirá la carga devuelta, que tendrá elvnamedecodificado a partir del parámetrocertpara que confirmes que se configure el nombre para mostrar correcto. Si es correcto, ve a Completar el registro de tu cuenta para completar el registro.
{
"account": [{
"vname": "decoded-vname-from-cert"
}]
}
Si se devuelven errores, consulta Mensajes de error y de estado para obtener más información.
Parámetros
| Nombre | Descripción |
|---|---|
| Obligatorio. Código de país numérico del número de teléfono que deseas registrar. |
| Obligatorio. Número de teléfono que deseas registrar, sin el código de país ni el signo más ( |
| Obligatorio. Método para recibir tu código de registro. |
| Obligatorio. Certificado con codificación Base64. |
| Opcional. PIN actual de 6 dígitos: solo se requiere si la verificación en dos pasos de esta cuenta está activada. |
Cambiar el PIN de la verificación en dos pasos
Para cambiar el PIN de verificación en dos pasos del número de teléfono de tu negocio:
- Sube tu portfolio comercial al administrador de WhatsApp.
- Si no se carga automáticamente el panel Números de teléfono, navega a Herramientas de la cuenta (el icono de la caja de herramientas) > Números de teléfono.
- Haz clic en el icono de configuración (engranaje).
- Haz clic en Verificación en dos pasos.
- Haz clic en Cambiar PIN y completa el proceso.
Debes proporcionar tu PIN actual para cambiarlo. Ten en cuenta que también puedes configurar un nuevo PIN usando nuestras API:
Desactivar la verificación en dos pasos
Para desactivar la verificación en dos pasos, sigue los pasos para cambiar tu PIN, pero haz clic en el botón Desactivar la verificación en dos pasos en el paso final. Se enviará un correo electrónico con un enlace a la dirección de correo electrónico asociada a tu portfolio comercial. Usa el enlace para desactivar la verificación en dos pasos. Una vez desactivada, puedes volver a activarla si configuras un nuevo PIN.
Preguntas frecuentes
Sí, puedes configurar un nuevo número de teléfono o cambiar el nombre verificado cuando estés en condiciones para el lanzamiento.
Se permiten los números gratuitos siempre y cuando incluyas tu código de país. El motivo es que los números gratuitos sin código de país no pueden identificarse de manera unívoca, ya que el mismo número puede aplicar a dos países diferentes.
Además, cabe destacar que existen complejidades adicionales relacionadas con los números gratuitos. Por lo general, si llamas a un número gratuito con el código de país cuando estás dentro del país, la llamada no podrá hacerse. Esto significa que existe una posibilidad de que los clientes de tu país intenten marcar el número que aparece en el contacto de la empresa (con código de país incluido) y no puedan comunicarse contigo. Si esto te preocupa, deberás informarles al respecto de manera explícita.
Para obtener más información sobre números gratuitos, consulta aquí.
Si haces una copia de seguridad de tu configuración actual y la restauras en una nueva computadora, la información de registro debería migrar junto con el resto de la implementación. Consulta la documentación sobre la configuración de copias de seguridad y restauración para obtener más información.
Puedes registrar nuevos números de teléfono y eliminar aquellos viejos de tu cuenta de WhatsApp en el administrador comercial de Facebook.
- Desde tu cuenta de WhatsApp, ve a Configuración.
- Haz clic en Administrador de WhatsApp.
- Selecciona la pestaña Números de teléfono. Aquí podrás administrar todos los números de teléfono de la cuenta.
Si el proceso de registro no funciona con "sms" a causa de demasiados intentos y recibes el mensaje "access denied" (acceso denegado), intenta registrarte mediante "voice" (llamada de voz).
Lamentablemente, tendrás que elegir un número de teléfono distinto que pueda recibir llamadas de voz o SMS para que podamos enviarte el código de registro. Anteriormente, permitíamos códigos de registro manuales, pero ya no admitimos esta opción. Los números de teléfono que usaban códigos de registro manuales continuarán siendo compatibles en la medida que resulte necesario. En el caso de los nuevos números de teléfono, entregaremos códigos de registro únicamente a través de SMS o llamadas de voz.
Si quieres usar un número de teléfono gratuito o 1-800, consulta esta guía.