API de Pulvify
Gestiona sesiones de WhatsApp mediante instancias: envía mensajes, gestiona grupos, comunidades, contactos, canales y webhooks a través de una API REST simple.
69
8
JSON
Autenticación
Todas las llamadas van a https://api.pulvify.com. Las rutas /instances usan el token de la cuenta; las rutas /{instance}/... usan el api-key de la instancia que recibirá la operación.
Token de la cuenta
Envíalo en el header account-token. Genéralo en Configuración > API en el panel; crea, lista y elimina instancias respetando el límite de tu plan.
Token de la instancia
Envíalo en el header api-key. Cada instancia de WhatsApp tiene su propio token, disponible en la página de la instancia del panel.
Variables de la colección
| {{base_url}} | URL del gateway de la API (https://api.pulvify.com). |
| {{instance}} | Slug de la instancia (sesión) que recibirá la operación. |
| {{account_token}} | Token de tu cuenta (header account-token), usado en las rutas /instances. |
| {{instance_token}} | Token de la instancia (header api-key). |
| {{group_id}} | JID del grupo, en el formato ID_DEL_GRUPO@g.us. |
| {{community_id}} | JID de la comunidad, en el formato ID_DE_LA_COMUNIDAD@g.us. |
| {{webhook_id}} | Identificador del webhook creado en la instancia. |
| {{jid}} | JID del canal/newsletter, en el formato ID_DEL_CANAL@newsletter. |
Eventos de webhook
Al crear un webhook, elige qué categorías de eventos deseas recibir. Usa ["*"] para recibir todo. El payload llega en el formato {event, eventId, sessionId, data}.
| connection | Código QR, emparejamiento, conexión y desconexión. |
| history | Historial recibido de WhatsApp (no es consulta retroactiva). |
| messages | Nuevos mensajes de conversas individuales y grupos. |
| messages_update | Recibos, ediciones, eliminaciones, reacciones y votos. |
| newsletter_messages | Nuevas publicaciones de canales de WhatsApp. |
| call | Oferta, aceptación, rechazo y finalización de llamadas. |
| contacts | Agenda, nombres, descripción, identidad y fotos de contactos. |
| presence | Presencia, escritura y grabación (depende de la suscripción de presencia). |
| groups | Participantes, permisos, metadatos y fotos de grupos. |
| labels | Creación, edición y eliminación de etiquetas. |
| chats | Archivar, fijar, silenciar, marcar leído, limpiar y eliminar conversas. |
| chat_labels | Asociación y eliminación de etiquetas en conversas. |
| blocks | Lista de bloqueos y cambios. |
Headers
Cuerpo de la solicitud