Empezando

Quickstart

Tu primera llamada a la API de Wapsy en menos de 5 minutos.

1. Crea un token

Ve a Ajustes → Tokens API y crea uno. Cópialo — se muestra una sola vez.

2. Lista tus contactos

curl -H "Authorization: Bearer vsk_xxxxxxxx" \
  https://app.wapsy.co/api/contacts?limit=10

Respuesta:

[
  {
    "id": "...",
    "fullName": "María González",
    "email": "maria@example.com",
    "phone": "+573001234567",
    "createdAt": "2026-05-28T10:30:00Z"
  }
]

3. Crea un contacto

curl -X POST -H "Authorization: Bearer vsk_xxxxxxxx" \
  -H "content-type: application/json" \
  -d '{"fullName":"Pedro","email":"pedro@example.com","phone":"+573001234567"}' \
  https://app.wapsy.co/api/contacts

4. Escucha eventos

Configura un webhook saliente en Ajustes → Webhooks para recibir eventos cada vez que algo importante pasa (nueva conversación, mensaje, deal ganado, etc.).

Wapsy firma cada evento con HMAC-SHA256 — verifica en tu endpoint con el header x-wapsy-signature.

Siguiente paso

→ Webhooks salientes con ejemplo de verificación en Node.js