API REST de WhatsApp + PHP: envío de mensajes con WhatzMeAPI

¿Tus clientes escriben por WhatsApp y no reciben respuesta? Descubre cómo una solución multiagente evita mensajes perdidos, mejora tiempos de respuesta y convierte más ventas.
CONTÁCTANOS

WhatzMeAPI te permite enviar y recibir mensajes de WhatsApp con una API REST simple y estable usando tu propio número. Ideal para notificaciones, recordatorios, ventas y soporte sin fricción técnica.

¿Por qué WhatzMeAPI?

• Integración rápida: regístrate, vincula tu número con QR y envía en minutos.
• Muy estable: pensada para producción, con respuesta consistente.
• Sencilla: endpoints claros, JSON limpio y ejemplos listos.
• Flexible: texto, medios, estados y webhooks para eventos.

Requisitos

1. Crear tu cuenta en WhatzMeAPI y obtener tu token.
2. Vincular tu número de WhatsApp escaneando el QR desde tu panel.
3. Tener la Base URL asignada (por ejemplo: https://tu-instancia.whatzmeapi.com).
4. PHP 8.x (opcional: Composer si usas Guzzle).

Enviar tu primer mensaje en PHP (cURL “puro”

<?php
$baseUrl = getenv('WHATZME_BASE_URL') ?: 'https://tu-instancia.whatzmeapi.com';
$token   = getenv('WHATZME_TOKEN'); // o pégalo directo mientras pruebas
$to      = '+5215555555555';        // E.164
$body    = '¡Hola! Probando envío desde PHP con WhatzMeAPI';

$payload = [
  'to'   => $to,
  'type' => 'text',
  'text' => ['body' => $body],
];

$ch = curl_init("$baseUrl/messages");
curl_setopt_array($ch, [
  CURLOPT_HTTPHEADER     => [
    "Authorization: Bearer $token",
    "Content-Type: application/json"
  ],
  CURLOPT_POST           => true,
  CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT        => 20,
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$err      = curl_error($ch);
curl_close($ch);

if ($err) {
  http_response_code(500);
  die("Error cURL: $err\n");
}

echo "HTTP $httpCode\n$response\n";

Notas útiles

• Usa variables de entorno para WHATZME_TOKEN y WHATZME_BASE_URL.
• Si recibes 429 (límite), aplica exponential backoff.
• Registra message_id y estatus para trazabilidad.

Alternativa con Guzzle (Composer)

composer require guzzlehttp/guzzle

<?php
require __DIR__ . '/vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

$client = new Client(['base_uri' => getenv('WHATZME_BASE_URL')]);
$token  = getenv('WHATZME_TOKEN');

try {
  $res = $client->post('/messages', [
    'headers' => [
      'Authorization' => "Bearer $token",
      'Content-Type'  => 'application/json',
    ],
    'json' => [
      'to'   => '+5215555555555',
      'type' => 'text',
      'text' => ['body' => 'Hola desde Guzzle + WhatzMeAPI'],
    ],
    'timeout' => 20,
  ]);
  echo $res->getStatusCode() . PHP_EOL;
  echo (string) $res->getBody() . PHP_EOL;
} catch (RequestException $e) {
  echo $e->getMessage();
}

Recibir mensajes y estados con Webhook (PHP sencillo)

<?php
// webhook.php
header('Content-Type: application/json; charset=utf-8');

$raw = file_get_contents('php://input');
$evt = json_decode($raw, true);

// ACK inmediato para evitar reintentos
http_response_code(200);

// Log básico
file_put_contents(__DIR__ . '/webhook.log', date('c') . ' ' . $raw . PHP_EOL, FILE_APPEND);

// Ruta por tipo
$type = $evt['type'] ?? null;
switch ($type) {
  case 'message_incoming':
    // Guardar en BD, invocar tu bot, etc.
    // Ej: $evt['message']['from'], $evt['message']['text']['body']
    break;
  case 'delivered':
  case 'read':
  case 'failed':
    // Actualizar estatus usando message_id
    break;
}

echo json_encode(['ok' => true]);

Cómo activarlo

1. Publica webhook.php con HTTPS.
2. Configura tu URL de webhook en tu panel de WhatzMeAPI.
3. Verifica que recibes eventos message_incoming, delivered, read, failed.

Buenas prácticas para producción

• Formato E.164 (+52…).
• Idempotencia al reenviar mensajes tras errores temporales.
• Colas/Workers para picos (envío masivo sin bloquear tu app).
• Observabilidad: logs, métricas y alertas (5xx/429).
• Seguridad: token en variables de entorno o secret manager.

Documentación y acceso

• Sitio: https://www.whatzmeapi.com/
• Doc de endpoints (Postman): https://documenter.getpostman.com/view/4045446/2sB3HjNMgi

CTA (pasos para empezar hoy)

1. Regístrate en WhatzMeAPI.
2. Envíanos el correo con el que te registraste.
3. Te mandamos un QR para vincular tu número.
4. Copia el ejemplo de arriba y… ¡listo, a enviar!

Conoce WhatzMeAPI (API REST + Chatbot): WhatzMeApi