API local de la Plataforma de WhatsApp Business

Cuenta

/v1/account

El nodo account sirve para registrar el 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 otro número registrado.

Perímetros

Los perímetros siguientes están conectados a este nodo:

PerímetroDescripción

/verify

Una vez que hayas recibido el código de registro a través del método que has especificado, utiliza este perímetro para completar el registro de la cuenta.

Antes de empezar

Necesitarás lo siguiente:

Copia del certificado codificado mediante Base64.

Se genera automáticamente una cadena de certificado codificada mediante Base64, que se usa para la validación durante el registro del cliente de la API de WhatsApp Business.

  1. Ve a la Configuración de la empresa de tu cuenta de Meta Business Manager.
  2. Haz clic en Cuentas de WhatsApp en el menú Cuentas y, luego, selecciona tu cuenta de WhatsApp en la lista Cuentas de WhatsApp si aún no está destacada.
  3. Ve a la pestaña Configuración y haz clic en el botón Administrador de WhatsApp.
  4. En la pestaña Números de teléfono, debes ver una lista con los números de teléfono. Haz clic en el botón Ver del número de teléfono para el que quieres obtener el certificado.
    Obtención del certificado
  5. Un cuadro de diálogo emergente mostrará la cadena del certificado en un cuadro gris. Haz clic en Obtener certificado.
    Descargar la cadena del certificado
  6. Utiliza esta cadena de certificado en el parámetro cert cuando realices el registro con el extremo account.

Consulta la documentación Nombre para mostrar para obtener más información.

Restricciones

  • Debes usar la cuenta admin para registrar la aplicación.
  • Si estás volviendo a registrar tu cuenta, la aplicación principal se deberá reiniciar una vez que se complete el registro.

Solicitud

Realiza una llamada POST a este extremo para solicitar un código de registro. En tu llamada, añade el número de teléfono y la cadena de certificado con la codificación Base64. Puedes recibir el código a través de SMS o de una 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
}

En función de la respuesta recibida, el procedimiento de registro se puede considerar finalizado o requerir otro paso para completarse. Si la operación se realiza correctamente, recibirás uno de los códigos de estado HTTP siguientes. Sigue las instrucciones correspondientes a la respuesta que has recibido:

  • 201 Created: la cuenta ya existe. Ya estás registrado, por lo que no tienes que hacer nada más.
  • 202 Accepted: la cuenta no existe. En función del método seleccionado en la solicitud, comprueba en el SMS o la llamada de voz el código de registro. Esta respuesta incluirá una carga devuelta con el elemento vname descodificado del parámetro cert para que confirmes que se está estableciendo el nombre para mostrar correcto. Si es correcto, dirígete a Finalización del registro de la cuenta para completar el registro.
{
  "account": [{
      "vname": "decoded-vname-from-cert"
  }]
}

Si se devuelve algún error, consulta Mensajes de error y de estado para obtener más información.

Parámetros

NombreDescripción

cc

Obligatorio.

Código de país numérico del número de teléfono que registras.

phone_number

Obligatorio.

Número de teléfono que registras, sin el código de país ni el símbolo más (+).

method

Obligatorio.

Método de recepción del código de registro.
Opciones:voice, sms

cert

Obligatorio.

Certificado con codificación Base64.

pin

Opcional.

PIN de 6 dígitos existente: solo se requiere cuando la verificación en dos pasos está activa en esta cuenta.

Cambiar el PIN de verificación en dos pasos

Para cambiar el PIN de verificación en dos pasos del número de teléfono de empresa, sigue estos pasos:

  1. Carga el porfolio empresarial en el Administrador de WhatsApp.
  2. Si no carga automáticamente la ventana Números de teléfono, navega a Herramientas de la cuenta (el icono de la caja de herramientas) > Números de teléfono.
  3. Haz clic en el icono de configuración (engranaje) del número de teléfono.
  4. Haz clic en Verificación en dos pasos.
  5. Haz clic en Cambiar PIN y completa el proceso.

Debes indicar el PIN actual para poder cambiarlo. Ten en cuenta que también puede establecer un nuevo PIN con nuestras API:

Desactivar la verificación en dos pasos

Para desactivar la verificación en dos pasos, sigue los pasos para cambiar el PIN, pero, en lugar del último paso, haz clic en el botón Desactivar la verificación en dos pasos. Se enviará un correo electrónico con un enlace a la dirección de correo electrónico asociada al porfolio empresarial. Usa el enlace para desactivar la verificación en dos pasos. Una vez desactivada, puedes establecer un nuevo PIN para volver a activarla.

Preguntas frecuentes

Sí, es posible configurar un nuevo número de teléfono o cambiar el nombre verificado cuando estés listo para publicar.

Enlace permanente

Se permiten los números gratuitos siempre que se incluya el código de país. El motivo es que los números gratuitos sin código de país no se pueden identificar de forma exclusiva: se puede aplicar el mismo número para dos países distintos.

Además, los números gratuitos presentan complejidades añadidas. Normalmente, si llamas a un número gratuito con el código de país desde dentro de este país, se produce un error. Esto significa que es probable que los clientes de tu país intenten marcar lo que aparece en el contacto empresarial (código de país incluido) y que no puedan ponerse en contacto contigo. Si esto supone un problema, comunícaselo explícitamente.

Puedes obtener más información acerca de los números gratuitos aquí.

Enlace permanente

Si realizas una copia de seguridad de tu configuración actual y la restauras en la máquina nueva, la información de registro deberá pasarse con el resto de la implementación. Consulta la documentación sobre la configuración de la copia de seguridad y la restauración para obtener más información.

Enlace permanente

Puedes registrar números de teléfono nuevos y eliminar el anterior de tu cuenta de WhatsApp en Facebook Business Manager.

  1. En la cuenta de WhatsApp, ve a Configuración.
  2. Haz clic en Administrador de WhatsApp.
  3. Selecciona la pestaña Números de teléfono. Desde aquí podrás administrar todos los números de teléfono de esta cuenta.
Enlace permanente

Si el registro devuelve un error con el SMS porque se han realizado demasiados intentos y ves un mensaje de acceso denegado, intenta realizar el registro con la voz.

Enlace permanente

Tendrás que elegir otro número de teléfono que pueda recibir SMS o voz para que podamos enviarte el código de registro. En el pasado, permitíamos los códigos de registro manuales, pero, actualmente, no. Los números de teléfono que solían utilizar códigos de registro manuales seguirán siendo compatibles según sea necesario. En el caso de los números de teléfono nuevos, solo proporcionaremos los códigos de registro por SMS o llamada de voz.

Si quieres utilizar un número de teléfono gratuito o 1800, lee esta guía.

Enlace permanente

Más información