Get Started
Acá encontrarás una breve guía paso a paso para enviar y recibir mensajes utilizando la versión CLOUD de la plataforma WhatsApp Business.
Pre-requisitos & Setup básico
1. Recuperar API Keys
Para enviar solicitudes con la API de B2Chat Cloud debes solicitar un client_id
y un client_secret
al equipo de soporte a través del siguiente formulario de Solicitud de acceso al API.
Estos datos te permitirán usar el servicio de Autorización para recibir un token temporal que podrás usar con el resto de servicios del API.
Cada número de teléfono de WhatsApp registrado tiene sus propios client_id
y client_secret
2. Set Webhook
Para recibir notificaciones de mensajes entrantes y salientes, tienes que establecer una URL de webhook, que utilizaremos como destino para todas las notificaciones que pertenezcan a tu número de teléfono de WhatsApp.
Para configurar tu URL de webhook deberás en el formulario Solicitud de acceso al API solicitarnos la configuración del webhook.
3. Autorización
Para poder usar los servicio de envío de mensajes primero debes autorizarte con el client_id y client_secret para obtener el token de acceso a los servicios del API
El endpoint de Autenticación es el siguiente:
https://authwabsp.b2chat.io/oauth2/token
El token es válido por 24 horas desde su generación. Después de ese tiempo, deberás generar uno nuevo para volver a acceder al API.
Ejemplo de solicitud
Respuesta
4. Enviar Mensaje
Una vez que obtengas el acces_token
, y tengas un PHONE_NUMBER
podrás empezar a enviar mensajes.
Si este PHONE_NUMBER
no ha enviado ningún mensaje a tu cuenta de WhatsApp Business en las últimas 24 horas, sólo podrás contactar con este número mediante un mensaje de template.
Send Message
GET
https://wabsp.b2chat.io/messages
Para enviar un mensaje de texto, utilice la URL de solicitud y los siguientes parámetros del cuerpo. Tener en cuenta que este servicio solo se puede usar si el PHONE_NUMBER
te ha enviado un mensaje en las últimas 24 horas, de no ser asi debes enviar el mensaje con un template.
Request Body
messaging_product*
String
recipient_type*
String
individual
to*
String
PHONE_NUMBER
type*
String
text
text*
String
body of message
Para los mensajes sin plantilla, enviar un mensaje a un número de teléfono sin una cuenta de WhatsApp dará lugar a una notificación webhook relacionada con el intento de mensajería que contendrá un código de error 470.
Ejemplo request
Last updated