¿Cómo usar?
Vincular número
Conecta tu número o cualquier otro a través de un código QR para pruebas
Prueba los métodos del API
Comienza en tan solo 1 minuto, gracias a una herramienta conveniente para desarrolladores
Configura tu Webhook
Selecciona y configura los hooks para cualquier evento en WhatsApp para enviar y recibir mensajes y otros eventos
¿Qué es Whapi.Cloud?
Whapi.Cloud es un avanzado gateway de API de WhatsApp diseñado para optimizar las soluciones de mensajería para empresas y desarrolladores. Permite una integración perfecta con herramientas para automatizar flujos de trabajo, gestionar grupos, enviar mensajes masivos y mejorar las interacciones con los clientes de manera sencilla.
Diseñado para ser flexible, Whapi.Cloud ofrece características potentes más allá de la API oficial, como soporte para la gestión de comunidades y actualizaciones de estado personalizadas. Con precios transparentes, documentación robusta y SDKs fáciles de usar, es la opción ideal para escalar operaciones en WhatsApp manteniendo la eficiencia y la fiabilidad.
Echa un vistazo a la API de WhatsApp
Actualizamos regularmente nuevas características para mejorar tu experiencia. Si estás buscando una característica que falta, por favor contacta a nuestro equipo de soporte.
Documentación de WhatsApp API PHP SDK
Instalación
composer require whapi-cloud/whatsapp-api-sdk-php
Configuración Inicial
use OpenAPI\Client\Api\MessagesApi;
use OpenAPI\Client\Configuration;
// Initialize the client
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()
->setApiKey('token', "your_token")
->setAccessToken("your_token");
$apiInstance = new OpenAPI\Client\Api\MessagesApi(
new GuzzleHttp\Client(),
$config
);
API de Mensajes
Envío de Mensajes de Texto
// Create text message object
$sender_text = new \OpenAPI\Client\Model\SenderText();
$sender_text->setTo('13016789891'); // Include country code
$sender_text->setBody('Your message here'); // Message content
// Optional parameters
$sender_text->setEphemeral(3600); // Message visibility time in seconds
$sender_text->setViewOnce(true); // View once setting
$sender_text->setTypingTime(5.0); // Typing simulation duration
$sender_text->setNoLinkPreview(false); // Enable/disable link previews
// Send the message
$result = $apiInstance->sendMessageText($sender_text);
print_r($result);
Envío de Imágenes con Descripciones
// Create image message object
$sender_image = new \OpenAPI\Client\Model\SenderImage();
$sender_image->setTo('13016789891'); // Recipient's number
$sender_image->setCaption('Image caption');
$sender_image->setMedia('https://example.com/image.jpg');
// Send the image
$result = $apiInstance->sendMessageImage($sender_image);
print_r($result);
Recuperación de Mensajes
Obtener Múltiples Mensajes
// Parameters
$count = 100; // Number of messages to retrieve
$offset = 0; // Pagination offset
// Get messages
$result = $apiInstance->getMessages($count, $offset);
print_r($result);
Obtener Mensaje Único
// Get message by ID
$message_id = "your_message_id";
$result = $apiInstance->getMessage($message_id);
print_r($result);
API de Grupos de WhatsApp
Creación de Grupos
$apiInstance = new OpenAPI\Client\Api\GroupsApi(
new GuzzleHttp\Client(),
$config
);
// Create group request
$create_group_request = [
"subject" => "Group Name",
"participants" => [
"13016789891",
"13016789892"
]
];
// Create the group
$result = $apiInstance->createGroup($create_group_request);
print_r($result);
Notas Importantes
- Números de Teléfono:
- Siempre incluya el código de país (por ejemplo, '13016789891' para un número de EE.UU.)
- No utilice caracteres especiales ni espacios
- URLs de Medios:
- Deben ser accesibles públicamente
- Soporte para formatos de imagen comunes (JPEG, PNG, etc.)
- Opciones de Mensaje:
- Efímero: Tiempo en segundos antes de que el mensaje desaparezca
- VerUnaVez: El mensaje solo puede verse una vez
- TiempoDeEscritura: Simula un retraso natural en la escritura
Manejo de Errores
try {
$result = $apiInstance->sendMessageText($sender_text);
print_r($result);
} catch (Exception $e) {
echo "Error: " . $e->getMessage();
}
- Evite enviar demasiados mensajes en rápida sucesión
- Implemente un manejo adecuado de errores
- Almacene y maneje los IDs de mensajes para su seguimiento
- Monitoree regularmente las respuestas de la API
- Mantenga un registro adecuado para la depuración