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

curl --location --request POST 'https://authwabsp.b2chat.io/oauth2/token' \
--header "Authorization: Basic $(echo -n 'client_id:client_secret' | base64)" \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials// Some code

• Respuesta

#200
{
    "access_token": "ACCESS_TOKEN",
    "expires_in": 86400,
    "token_type": "Bearer"
}

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

Name	Type	Description
messaging_product*	String	whatsapp
recipient_type*	String	individual
to*	String	PHONE_NUMBER
type*	String	text
text*	String	body of message

200: OK

{
  "messaging_product": "whatsapp",
  "contacts": [{
      "input": "PHONE_NUMBER",
      "wa_id": "WHATSAPP_ID",
    }]
  "messages": [{
      "id": "wamid.ID",
    }]
}

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

curl --location --request POST 'https://wabsp.b2chat.io/messages' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "PHONE_NUMBER",
  "type": "text",
  "text": { // the text object
    "preview_url": true,
    "body": "Message content including a URL begins with https:// or http://"
  }
}'