Servicios web para obtener números de WhatsApp

Servicios web para obtener números de WhatsApp

Números

/webhook/numbers

Usa el nodo numbers para obtener tus números de teléfono de WhatsApp.

Este documento contiene:

  1. Pre-requisitos
  2. Peticiones
  3. Respuestas
  4. Ejemplo

Pre-requisitos

  1. Una cuenta de Woztell activada.
  2. Para usar la API de Woztell, primero debes autenticarte y recibir un token que permita el acceso al servicio. Ponte en contacto con support@woztell.com para obtener más información sobre cómo hacerlo.

Peticiones

Las llamadas a la API de mensajes se envían al endpoint /numbers independientemente de los números. Consulta la siguiente documentación para obtener más información:
GET https://webservice.woztell.com/webhook/numbers
{
	"WOZTELL_ADMIN":"your-woztell-admin-email",
	"WOZTELL_TOKEN":"your-woztell-token"
}
Parámetros:

Nombre del parámetro

Tipo de dato

Descripción

Valores posibles

WOZTELL_ADMIN*

String

Dirección de email de tu cuenta de Woztell.

admin@company.com

WOZTELL_TOKEN*

String

Tu token de la cuenta de Woztell.

abc-defgh-ijk-123

* Parámetros requeridos


Respuesta

La información sobre los tipos de mensajes de error y estado se describen a continuación:

ESTADO

DESCRIPCIÓN

ERROR

              MÉTODO NO VÁLIDO

ERROR

             AUTORIZACIÓN INVÁLIDA

{
	"STATUS":"ERROR",
	"DESCRIPTION":"INVALID JSON DATA"
}

ESTADO

NÚMEROS

ÉXITO

                  JSON con números


{
	"STATUS":"SUCCESS",
	"NUMBERS": {
        "0": {
            "NUMBER": "0016315551002",
            "DESCRIPTION": "USA"
        },
        ...
        "N": {
            "NUMBER": "0034666777888",
            "DESCRIPTION": "SPAIN"
        }
}

Parámetros de respuesta:

Nombre del parámetro

Tipo de dato

Descripción

Valores posibles

NÚMERO

String

Tu número de teléfono de WhatsApp. Siempre en formato internacional.

0016315551002, 0034666777888, ...

DESCRIPCIÓN

String

Descripción del número de teléfono de WhatsApp. La descripción será definida por el cliente al suscribir el servicio.

"USA", "Departamento de ventas", "Equipo de España",....


Ejemplo

Cuando se envía un mensaje en una solicitud, el cliente recibirá un mensaje como este:


GET https://webservice.woztell.com/webhook/messages
{
 "WOZTELL_ADMIN":"admin@woztell.com",
 "WOZTELL_TOKEN":"123-45678-90abcdefg-hij-klmn"
}
Puedes usar este PHP para enviar mensajes de WhatsApp usando tu cuenta de Woztell:
<?php
$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://webservice.woztell.com/webhook/templates?WOZTELL_ADMIN=admin@woztell.com&WOZTELL_TOKEN=123-45678-90abcdefg-hij-klmn',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET'
));
 
$response = curl_exec($curl);
 
curl_close($curl);
echo $response;
Si necesita más ayuda, contáctanos en support@woztell.com