Credenciales de la API de Whatsapp Business Cloud API

Guía para obtener tokens, claves y conexiones

Conectar al API de WhatsApp Cloud Business requiere que realices una serie de pasos en Facebook para obtener un token de acceso, un 'Identificador de número de teléfono', un 'Identificador de la cuenta de WhatsApp Business' y un número de teléfono temporal. Este último te servirá para comenzar ya a utilizar el API de WhatsApp hasta que decidas reemplazarlo por un número de WhatsApp real.

Antes de continuar te recomiendo revisar las preguntas frecuentes para hacer una primera idea de las posibilidades y también limitaciones del API oficial de WhatsApp.

Activar autenticación en 2 pasos

En primer lugar Meta recomienda que actives la autenticación en dos pasos en tu cuenta de Facebook. Esta es una función de seguridad que junto a la contraseña ayuda a proteger tu cuenta.

  1. 1

    Accede a https://facebook.com

  2. 2

    Haz clic en tu foto del perfil en la parte superior derecha

  3. 3

    Haz clic en 'Configuración y privacidad'.

  4. 4

    Haz clic en 'Configuración'.

  5. 5

    Haz clic en 'Centro de cuentas' y, luego, en 'Contraseña y seguridad'

  6. 6

    Haz clic en 'Autenticación en dos pasos' y selecciona la cuenta que quieres actualizar.

  7. 7

    Elige el método de seguridad que quieras agregar y sigue las instrucciones que aparecen en pantalla.

Registrar tu aplicación de WhatsApp

  1. 1

    Accede a https://developers.facebook.com

  2. 2

    Haz clic en 'Mis apps'

  3. 3

    Haz clic en 'Crear app'

  4. 4

    En el campo 'Nombre de la app' escribe un nombre para tu aplicación. Por ejemplo 'botize'

  5. 5

    Haz clic en 'Siguiente'

  6. 6

    En el apartado 'Agregar casos de uso' selecciona opción 'Otro' y haz clic en 'Siguiente'

  7. 7

    En 'Selecciona un tipo de app' selecciona 'Negocios' y haz clic en 'Siguiente'

  8. 8

    Haz clic en 'Crear app'

  9. 9

    Te llevará a un apartado llamado 'Agrega productos a tu app'

Configurar el módulo de WhatsApp

  1. 1

    Dentro del apartado 'Agrega productos a tu app' puedes ver una serie de bloques con nombre como 'Messenger', 'Instagram', 'WhatsApp', etc. Identifica el bloque de 'WhatsApp'.

  2. 2

    Haz clic en el botón 'Configurar' del bloque dedicado a 'WhatsApp'

  3. 3

    Te llevará a un apartado llamado 'Plataforma de WhatsApp Business', allí haz clic en el botón 'Continuar'

  4. 4

    Haz clic en 'Configuración de la API'

Número de teléfono de pruebas

En este punto WhatsApp te ha creado un teléfono de pruebas cuyo número aparece en el campo 'De'.<br><br>Utiliza este número para hacer tus primeras pruebas hasta que quieras utilizar un número de real de WhatsApp.<br><br>El número de pruebas solo podrá ser usado para enviar y recibir mensajes de un máximo de 5 contactos que tú elijas.<br><br>Vamos a crear ahora un primer contacto que puede ser por ejemplo tu número personal de WhatsApp

  1. 1

    Haz clic en 'Para' y secciona 'Administrar lista de números de teléfono'

  2. 2

    Escribe tu número de teléfono y haz clic en 'Siguiente'

  3. 3

    Recibirás un código de verificación en tu teléfono. Introdúcelo y pulsa 'Siguiente'.

    A partir de estos momentos podrás, desde el número de pruebas enviar y recibir mensajes desde este número.

    Puedes repetir este proceso con otros 4 números de teléfono más.

Configuración de Webhooks

  1. 1

    Baja directamente hasta el paso 3 y haz clic en el botón 'Configurar Webhooks'

  2. 2

    En el campo 'URL de devolución de llamada' escribe: https://botize.com/callbacks/whatsapp

  3. 3

    En el campo 'Token de verificación' escribe: 10005184KTSJ

  4. 4

    Haz clic en el botón 'Verificar y guardar'

  5. 5

    Verás ahora una lista llamada 'Campos del Webhook', busca el campo llamado 'messages'

  6. 6

    A la derecha del campo 'messages' activa el botón 'no suscritos'. Al hacerlo cambiará a 'Suscritos'.

Obtener el Identificador de número de teléfono

  1. 1

    En el menú izquierdo haz clic en el apartado 'Configuración de la API'

  2. 2

    Copia el 'Identificador de número de teléfono' en un lugar seguro.

Obtener el Identificador de la cuenta de WhatsApp Business

  1. 1

    En el menú izquierdo haz clic en el apartado 'Configuración de la API'

  2. 2

    Copia el 'Identificador de la cuenta de WhatsApp Business' en un lugar seguro.

Crear un token

  1. 1

    Accede a http://business.facebook.com/settings

  2. 2

    En el menú izquierda haz clic en el apartado 'Usuarios del sistema'

  3. 3

    Haz clic en el botón '+ Agregar'

  4. 4

    En el campo 'System user name' escribe un nombre, por ejemplo 'botize'

  5. 5

    En el campo 'System user role' selecciona 'admin'

  6. 6

    Haz clic en el botón 'Create system user'

  7. 7

    Haz clic en el botón 'Asignar activos'

  8. 8

    En la columna 'Seleccionar tipo de activo', selecciona 'Apps'

  9. 9

    En la columna 'Seleccionar activos', selecciona tu aplicación de WhatsApp que has creado

  10. 10

    En la columna 'Asignar permisos', selecciona 'Administrar App'

  11. 11

    Haz clic en el botón 'Asignar activos'

  12. 12

    En el menú izquierdo haz clic en el apartado 'Cuentas de WhatsApp'

  13. 13

    Haz clic en 'Test WhatsApp Business Account' para que quede seleccionada

  14. 14

    Haz clic en el botón 'Agirnar personas'

  15. 15

    Selecciona la persona que aparece con el texto 'usuario de sistema'

  16. 16

    A la derecha marca la opción 'Administrar cuentas de WhatsApp Business'

  17. 17

    Pulsa el botón 'Asignar'

  18. 18

    En la columna izquierda vuelve al apartado 'Usuarios del sistema'

  19. 19

    Pulsa el botón 'Generar token'

  20. 20

    Selecciona de la lista tu aplicación de WhatsApp y pulsa el botón 'Siguiente'

  21. 21

    Selecciona la opción 'Nunca' para la caducidad del token y pulsa el botón 'Siguiente'

  22. 22

    Selecciona los permisos 'whatsapp_business_messaging' y 'whatsapp_business_management'

  23. 23

    Haz clic en el botón 'Generar token'

  24. 24

    Copia el token en un lugar seguro

  25. 25

    Haz clic en el botón 'Listo'

Video tutorial paso a paso