En esta guía paso a paso, describiremos en detalle cómo obtener la API de WhatsApp Business a través del socio oficial de Facebook - el servicio Gupshup e integrarlo con los Canales Abiertos de Bitrix24 CRM.

Si ya tiene una cuenta de Facebook Business Manager, omita este paso y continúe con el siguiente.

Inicie sesión en su cuenta personal de Facebook y cree una cuenta de Business Manager siguiendo el enlace https://business.facebook.com/overview y haciendo clic en el botón "CREAR CUENTA", se abrirá una ventana para ingresar los datos de la empresa.

De acuerdo con las indicaciones sobre los campos, ingrese el nombre de la empresa, nombre y apellido, correo electrónico y presione el botón "Enviar".

En la siguiente ventana, ingrese la información sobre la empresa y presione el botón "Enviar".

Después del envío, aparecerá un mensaje que indica que se ha creado la cuenta y debe confirmar su dirección de correo electrónico.

Vayamos al correo y haga clic en el botón "Confirm Now" de la carta.

Si ya tiene este botón activo o su empresa ya ha sido verificada en Facebook Business Manager, omita este paso y continúe con el siguiente.

De forma predeterminada, el botón para iniciar la verificación comercial en Facebook Business Manager está deshabilitado. Para activarlo, debe realizar los pasos que se describen a continuación.

Inicie sesión en https://developers.facebook.com. Para hacer esto, haga clic en el elemento "Comenzar" en el menú superior.

En la siguiente ventana, haga clic en el botón "Continuar".

En la siguiente ventana, marque la casilla y haga clic en el botón "Confirmar correo electrónico".

En la siguiente ventana, seleccione "Desarrollador" y haga clic en el botón "Completar registro".

En la siguiente ventana, haga clic en el botón "Crear aplicación".

En la siguiente ventana, seleccione "Administrar integraciones comerciales" y haga clic en el botón "Continuar".

En la siguiente ventana, ingrese cualquier "Nombre para mostrar de la aplicación", seleccione "Propósito de la aplicación" - "Usted o su empresa propietaria", seleccione su "Cuenta de administrador comercial" y haga clic en el botón "Crear aplicación".

Después de crear correctamente la aplicación, se abrirá la página de inicio del panel de aplicaciones de Facebook.

El botón "Iniciar verificación" ahora está activo.

Si su empresa ya está verificada en Facebook Business Manager, omita este paso y continúe con el siguiente.

Vaya a la sección Centro de seguridad en https://business.facebook.com/settings/security. El botón "Iniciar verificación" ahora está activo. Haga clic en él para iniciar la confirmación.

La información oficial de Facebook sobre la verificación de la empresa se puede encontrar en el enlace: https://www.facebook.com/business/help/2058515294227817?id=180505742745347.

En el primer paso de verificación, ingresaremos los datos de nuestra empresa:

Nombre legal del negocio - el nombre de la empresa, como se indica en los documentos para el registro de la empresa.

País - el país donde está registrada la empresa.

Dirección postal - calle y número de casa de la dirección legal de la empresa, como se indica en los documentos para el registro de la empresa.

Dirección postal 2/localidad - ingrese, si está disponible.

Ciudad - la ciudad de la dirección legal de la empresa, como se indica en los documentos para el registro de la empresa.

Estado/provincia/región - la región del domicilio social de la empresa como se indica en los documentos de constitución de la empresa.

Código postal - El código postal del domicilio social de la empresa, como se indica en los documentos para el registro de la empresa.

Número de teléfono del negocio - el número de teléfono que pertenece a esta entidad legal (debe haber documentos de respaldo: acuerdo, facturas de pago del teléfono, etc.).

Sitio web - la dirección del sitio web de la empresa (el dominio del sitio web debe coincidir con el dominio de la dirección de correo electrónico de la empresa).

Después de ingresar los detalles de su empresa y hacer clic en el botón "Siguiente", Facebook intentará encontrar en fuentes abiertas todas las empresas cuyos detalles sean similares a los que ingresó.

1. Si se encuentran tales empresas, se mostrarán en la lista.

Elija la opción más adecuada o, si ninguna no encaja, seleccione "Ninguna de estas coincidencias" y haga clic en el botón "Siguiente".

Si su empresa está en la lista y la ha elegido, en el tercer paso, confirme los detalles de su empresa y haga clic en el botón "Siguiente".

En el cuarto paso, elija un método de verificación. Puede verificar su número de teléfono. Seleccione su idioma y solicite una llamada telefónica o un mensaje de texto.

2. Si Facebook no encontró su empresa en fuentes abiertas, o si no vio su empresa en la lista sugerida por Facebook, y elige "Ninguno de estos coincide".

Verifique su nombre comercial legal.

Para hacer esto, debe cargar un documento oficial estándar que coincida con el nombre comercial legal que ingresó.

Los documentos aceptados para el nombre legal incluyen:

• Licencia de negocios
• Certificado de formación o incorporación
• Certificado de registro de impuestos o IVA

Seleccione el idioma del documento, cargue los documentos y haga clic en el botón "Siguiente".

Verifique su dirección comercial o número de teléfono. Sube un documento que muestre el nombre legal de tu empresa junto con la dirección postal o el número de teléfono que ingresaste y haz clic en el botón "Siguiente".

Los documentos aceptados para dirección / teléfono incluyen:

• Factura de servicios públicos, como electricidad o teléfono
• Extracto bancario con dirección
• Licencia comercial con dirección o teléfono

Elija un método de verificación. Puede optar por verificar por teléfono o mediante el nombre de dominio de su sitio web. Es posible que se verifique más rápido si utiliza un correo electrónico asociado con el dominio de su sitio web.

Ingrese el código de verificación. Revise la bandeja de entrada de su correo electrónico e ingrese el código proporcionado. Haga clic en el botón "Enviar".

La página "Información comercial" https://business.facebook.com/settings/info mostrará el estado de verificación comercial "En revisión". Ahora debe esperar la aprobación de Facebook, esto puede demorar de 2 a 7 días hábiles.

La página del "Centro de seguridad" https://business.facebook.com/settings/security mostrará la Verificación comercial "Enviada".

Después de una verificación exitosa, el estado se actualizará a "Verificado".

Para crear una cuenta con Gupshup, solo necesita iniciar sesión en este servicio a través de cualquiera de sus cuentas existentes de Google, Facebook o GitHub en la página https://www.gupshup.io/developer/whatsapp-api.

Inmediatamente después de iniciar sesión, se abrirá el panel de WhatsApp. Allí hacemos clic en el botón "Create your first app".

A continuación, haga clic en el botón "Access API".

Introduzca cualquier nombre de aplicación gratuita, por ejemplo, "TestApp555" y haga clic en el botón "Enviar".

Se abrirá una página larga, desplácese hacia abajo con el mouse y haga clic en el botón "Siguiente" en la parte inferior.

A continuación, el botón "Ir al panel de control" aparecerá debajo, haga clic en él para ir allí.

En el panel https://www.gupshup.io/whatsapp/dashboard, haga clic en el botón "En vivo" en la aplicación creada.

En la siguiente pantalla, haga clic en "Estoy listo".

En la siguiente pantalla, seleccione su país.

Luego, desplácese hacia abajo en el marco y haga clic en "Siguiente".

En la siguiente pantalla complete el formulario con los datos de su empresa de acuerdo con la información de su empresa de Facebook Business Manager https://business.facebook.com/settings/info y haga clic en "Siguiente".

Se enviará un correo electrónico de Gupshup a la dirección de correo electrónico ingresada en el formulario con un botón para confirmarlo. Confirme este correo electrónico haciendo clic en el botón "Verificar ahora" en el cuerpo de la carta.

Después de la confirmación exitosa, se abrirá la ventana "Email Verification Complete"

y llegará una carta que indica que el correo electrónico se ha verificado correctamente.

Regrese a la ventana con el formulario. Verifique toda la información ingresada y haga clic en "Confirmar".

En la siguiente pantalla, ingrese el ID de su empresa verificada en Facebook Business Manager, que copias en la página https://business.facebook.com/settings/info, y haga clic en "Guardar".

Si su empresa aún no ha sido verificada, aparecerá un error: "The Facebook Business Manager ID does not seem to be verified. Please try again with a verified ID."

Si es así, primero deberá realizar la verificación de su empresa en Facebook Business Manager y luego volver a este paso. Este proceso se detalla en los pasos 1-3 de este manual.

Si todo está en orden y su empresa está confirmada, entonces se abrirá la siguiente pantalla, donde ingresamos nuestro número de teléfono que queremos usar para la API de WhatsApp Business. Antes de hacer esto, asegúrese de estudiar las reglas de Facebook para elegir dicho número de teléfono en el enlace.
http://developers.facebook.com/docs/whatsapp/guides/phone-number.

Seleccione el código del país e ingrese el número de teléfono, presione el botón "Guardar".

A continuación, ingresamos el nombre para mostrar de su empresa en WhatsApp. Antes de hacer esto, asegúrese de estudiar las reglas de Facebook para elegir un nombre para mostrar de un enlace: https://developers.facebook.com/docs/whatsapp/guides/display-name.

Ingrese un nombre para mostrar y haga clic en el botón "Guardar".

A continuación, deberá confirmar el enlace a Gupshup en su página de Facebook Business Manager, para esto, en una nueva pestaña del navegador, haga clic en el enlace https://business.facebook.com/settings/requests o en Facebook Business Manager en el menú de la izquierda, seleccione el elemento "Solicitudes". En la pestaña "Recibido" habrá una solicitud recibida de Gupshup, haga clic en el botón "Aprobar".

Regrese a la ventana de Gupshup y haga clic en el botón Aprobar.

Se abrirá una ventana con información de que su solicitud ha sido enviada y está esperando la aprobación de WhatsApp. Según se informa, esto demorará de 2 a 7 días hábiles. A menudo, todo sucede más rápido y quizás reciba una respuesta a su correo electrónico dentro de las 24 horas. Haga clic en el botón "Ir al panel de control".

Se abrirá la página principal del Dashboard y en la lista de aplicaciones en el botón azul veremos el estado actual "En espera de Aprobación".

Después de la aprobación, recibirá un correo electrónico de Gupshup y el estado en el botón azul cambiará a "Verificación completa".

A continuación, deberá confirmar su número de teléfono mediante SMS o llamada de voz. Para hacer esto, haga clic en el botón "Verificación completa".

En la ventana que se abre, haga clic en el botón "Solicitar código vía SMS" si el número de teléfono es móvil, o "Solicitar código vía llamada de voz" si el número de teléfono no es móvil.

Estamos esperando una actualización automática de la pantalla y enviando un código de confirmación a su número.

Luego de enviar el código a tu número, automáticamente se abrirá la siguiente pantalla, donde ingresamos el código recibido y presionamos el botón "Enviar".

Después de un envío exitoso, se abrirá la siguiente ventana con un mensaje de que la información de su cuenta ha sido aprobada y la verificación fue exitosa. Haga clic en el botón "Ir al panel de control".

Se abrirá la página principal del Dashboard y en la lista de aplicaciones veremos el estado actual en verde "LIVE". Ahora puede usar su número de teléfono en la API de WhatsApp Business.

También podemos personalizar el perfil de su empresa en WhatsApp, por ejemplo, cargar una foto de perfil e ingresar otra información sobre su empresa. Para ello, siga el enlace "Configuración de perfil" en la lista de aplicaciones para editar un perfil.

Se abrirá una ventana para editar el perfil, ingrese toda la información necesaria allí.

Después de ingresar los datos del perfil, haga clic en el botón "Guardar cambios".

Para comenzar a recibir y enviar mensajes a través de su número de teléfono conectado a WhatsApp Business API Gupshup, debe conectar su cuenta de Gupshup a su Bitrix24.

En Bitrix24, instale la aplicación WhatsApp Business API Gupshup del mercado, para hacer esto, siga el enlace https://www.bitrix24.es/apps/?app=aiappspro.whatsapp_business_api_gupshup y haga clic en el botón verde "INSTALAR".

Si aún no ha iniciado sesión en el mercado de Bitrix24, se abrirá una ventana emergente con el botón "LOGIN". Haga clic en él para iniciar sesión con su cuenta Bitrix24.

Si aún no tiene Bitrix24, haga clic en el enlace "CREA TU BITRIX24 AHORA" en la misma ventana emergente y registre Bitrix24 en su dirección de correo electrónico o usando una de sus cuentas de redes sociales propuestas.

Después de ingresar con éxito al mercado de Bitrix24, en la misma ventana emergente que apareció después de hacer clic en el botón verde "INSTALAR", seleccione su portal de Bitrix24 de la lista.

Su Bitrix24 se abrirá en una nueva pestaña de su navegador con una propuesta para instalar la aplicación WhatsApp Business API Gupshup. Presione el botón azul "INSTALAR".

Lea el acuerdo de licencia y la política de privacidad haciendo clic en los enlaces y marque las casillas si está de acuerdo con los términos. Haga clic en el botón verde "INSTALAR".

Después de una instalación exitosa, se creará automáticamente un chat de soporte de la aplicación 24/7 en su Bitrix24, en el que puede escribir en cualquier momento si tiene alguna pregunta sobre cómo trabajar con la aplicación.

Una vez instalada la aplicación, procedamos a la activación del conector para la API de WhatsApp Business en el Contact Center de Bitrix24.

Cierre la diapositiva de instalación de la aplicación, vaya al Centro de contacto de Bitrix24 y haga clic en el conector "WhatsApp Business API Gupshup" instalado.

En el control deslizante de configuración del conector abierto, haga clic en el botón "CONECTAR".

Si se han creado varios canales abiertos en su Bitrix24, a continuación deberá seleccionar el canal abierto requerido al que desea conectar WhatsApp y, después de seleccionarlo, haga clic en el botón "CONECTAR".

El mismo control deslizante abrirá la interfaz de configuración del conector.

En una nueva pestaña del navegador, vaya a su Panel de control de Gupshup utilizando el enlace https://www.gupshup.io/whatsapp/dashboard, haga clic en el icono de su perfil y copie la clave API en la ventana emergente.

Regrese a la ventana de configuración del conector en Bitrix24 y en el campo "Clave API de Gupshup" ingrese la Clave API copiada en su cuenta de Gupshup.

En una nueva pestaña del navegador, regrese a su Panel de control de Gupshup usando el enlace https://www.gupshup.io/whatsapp/dashboard y copie el número de teléfono para el campo "Remitente de Gupshup" haciendo clic en el enlace "Configuración" en el lista de aplicaciones en su cuenta de Gupshup.

Esto abrirá la interfaz de configuración de la aplicación en Gupshup, desplácese hacia abajo hasta la sección "Verificar el acceso a la API y establecer la URL de devolución de llamada" y copiar el número de teléfono del campo "Remitente". Si su propio número de teléfono aún está pendiente, este campo contendrá un número de teléfono de prueba de Gupshup, que puede usar para probar la aplicación por ahora.

No cierre esta ventana de configuración de la aplicación en Gupshup por ahora, será útil a continuación. Regrese a la ventana de configuración del conector en Bitrix24 e ingrese el número de teléfono del remitente copiado en el campo "Remitente de Gupshup".

Haga clic en el botón "Conectar". Después de una conexión exitosa, aparecerán los mensajes "Connector connected successfully" y "Copy callback URL and enter it in Gupshup settings". Copie la "Gupshup callback URL" haciendo clic en el botón "Copy".

Regrese a nuestra ventana de configuración de la aplicación abierta en Gupshup, haga clic en la pestaña "URL de devolución de llamada / Enlace a su bot", cambie el control deslizante a "ON".

Marque las casillas a continuación en "Seleccione qué eventos de estado de mensaje desea recibir a través de la URL de devolución de llamada". En el campo "Ingrese la URL de devolución de llamada", ingrese la "URL de devolución de llamada de Gupshup" copiada en la configuración del conector en Bitrix24 y presione el botón "Establecer" para aplicar la configuración.

¡El conector Gupshup de la API empresarial de WhatsApp está listo para funcionar!

Si todavía está esperando la aprobación de su número de teléfono y desea probar el conector a través de un número de teléfono de prueba de Gupshup por ahora, desplácese hacia arriba en la página de configuración de la aplicación en Gupshup hasta la sección "Mecanismos inteligentes para el registro y participación del usuario" y haga clic el icono "Haga clic en el enlace". Se abrirá un botón en una nueva pestaña para confirmar el consentimiento para recibir mensajes de prueba. Marque la casilla de verificación "Acepto ..." y haga clic en el botón "Enviar mensaje". La aplicación WhatsApp se abrirá para enviar el mensaje preestablecido "PROXY ..." desde su número personal de WhatsApp. Envíe este mensaje sin cambios al número de prueba de Gupshup. La respuesta será "¡Bienvenido! Ahora estás chateando con…". Ahora puede enviar mensajes de prueba que se enviarán al canal abierto de Bitrix24.

A continuación se muestran ejemplos de envío y recepción de mensajes a través de un número de teléfono del trabajo.

Envíe un mensaje, por ejemplo desde su número personal de WhatsApp, a su número de teléfono de la API empresarial de WhatsApp aprobado por Gupshup.

Acepta el mensaje en el Open Channel de tu Bitrix24 y escribe una respuesta.

Se admiten todos los tipos de mensajes: mensajes de texto, imágenes, videos, mensajes de voz, archivos, coordenadas de ubicación. Los mensajes se procesan de acuerdo con la configuración de Open Channel.

Para poder escribirle al usuario después de 24 horas desde el momento del último mensaje de él, es necesario preparar plantillas especiales y obtener su aprobación de WhatsApp. El mensaje no debe ser de naturaleza promocional: WhatsApp solo aprueba las plantillas de transacciones y servicios. Las plantillas deben cumplir con las siguientes pautas: Política comercial de WhatsApp, Política comercial de WhatsApp.

Las plantillas deben crearse en su cuenta de Gupshup. Para hacer esto, vaya al Panel de Gupshup en https://www.gupshup.io/whatsapp/dashboard, siga el enlace Configuración en la lista de aplicaciones de Gupshup.

Desplácese hacia abajo en la página de configuración que se abre a la sección "Verificar el acceso a la API y establecer la URL de devolución de llamada" y luego haga clic en el enlace "Ver plantillas".

La página Lista de plantillas se abre en una nueva pestaña del navegador. La lista que se abre contendrá solo plantillas para enviar a través del número de prueba de Gupshup marcado como "Permitido para su uso en el servidor de prueba". No podrá usarlos para su número, deberá crear sus propias plantillas.

Para agregar su propia plantilla, haga clic en el botón "Agregar más".

En la interfaz que se abre, complete todos los campos obligatorios y haga clic en el botón "Vista previa y enviar". A continuación se muestra un ejemplo de cómo completar los campos de nuestra plantilla aprobada.

Verifique todos los detalles y haga clic en el botón "Enviar".

Después del envío, esperamos de 1 a 2 días hábiles para que WhatsApp apruebe la plantilla. Al mismo tiempo, no llegan cartas, debe verificar el cambio de estado de las plantillas enviadas usted mismo en su cuenta de Gupshup. En el filtro, seleccione "Aprobado" y se abrirá una lista de todas sus plantillas aprobadas.

A continuación, en la captura de pantalla, se muestra un ejemplo de cómo enviar un mensaje de plantilla desde Bitrix24.

Durante la instalación en Bitrix24, la aplicación "WhatsApp Business API Gupshup" crea automáticamente un nuevo proveedor de SMS "[WhatsApp Business API Gupshup]", solo que este no envía SMS, sino mensajes a WhatsApp.

El envío se realiza tanto de forma manual como automática desde cualquier lugar del CRM: desde robots, procesos de negocio, correos SMS y Messenger desde la sección de marketing CRM, Timeline Leads, Deals, Contactos y Empresas.

Damos ejemplos de envío de dichos mensajes a continuación en las capturas de pantalla.

Hemos configurado completamente el popular y demandado canal de WhatsApp desde cero a través de la API oficial de WhatsApp Business.

En comparación con las API no oficiales, las principales ventajas de una conexión oficial son:

• alta estabilidad y seguridad;
• independencia del equipo físico (no es necesario mantener un teléfono móvil conectado a Internet todo el tiempo);
• independencia de la interfaz web de mensajes (no es necesario escanear el código QR y transferirlo a aplicaciones de terceros);
• amplias oportunidades de integración con sistemas externos para automatizar el procesamiento de mensajes.

Además, al conectar la API de WhatsApp Business a través del socio oficial de Facebook, el servicio Gupshup le permite reducir el costo de este canal varias veces en comparación con otros proveedores de la API oficial de WhatsApp Business. E incluso a menudo resulta más rentable en comparación con los costos de los esquemas de conexión no oficiales. Por ejemplo, muchos de estos servicios solo ofrecen paquetes de mensajes o diálogos con una tarifa mensual. Y una gran ventaja más, puede conectar un número ilimitado de sus números de teléfono para la API de WhatsApp Business a través de Gupshup, y esto no afecta el costo.