Documentación de la API

# Confirma que el token Bearer es válido y que la suscripción de la organización está activa antes de llamar a otros endpoints.
# HTTP 200: token correcto. 401: token ausente o no válido. 403: suscripción inactiva.

curl -X GET \
https://whapier.com/api/verify \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Parámetros de consulta opcionales: ?page=1&per_page=10 (per_page máx. 100).
# Los más recientes primero. Respuesta: data (objetos de contacto), links y meta (current_page, last_page, per_page, total).
# Un contacto: id, uuid, phone, first_name, last_name, email, address, metadata, groups (uuid, name), source, opted_in_at, opted_out_at, created_at, updated_at.
# Filtros de búsqueda, combinados con AND: phone (cualquier formato que el país de la organización pueda leer; 400 cuando no es un número), email (exacto, sin distinguir mayúsculas), q (de 2 a 128 caracteres, buscado en nombre, email y número), group (el uuid de un grupo de contactos; 400 si es desconocido), opted_out (true | false), updated_since (una fecha, UTC), source (api, manual, import, entry point...).

curl -X GET \
"https://whapier.com/api/contacts?page=1&per_page=10" \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# El objeto contacto de Obtener la lista de contactos más unread_messages, last_message_at y ticket (status, assigned_to: name, email).
# ticket es null mientras el ticketing está desactivado en Ajustes > Tickets, o cuando la conversación aún no tiene ticket. 404 cuando el uuid es desconocido, está eliminado o pertenece a otro espacio de trabajo.

curl -X GET \
https://whapier.com/api/contacts/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Campos del cuerpo JSON:
#   phone (obligatorio) — número internacional; se valida y se guarda en formato E.164. Debe ser único en cada organización (400 si está duplicado).
#   first_name, last_name, email (opcionales) — omítelos o envíalos como null o "" para contactos sin nombre.
#   street, city, state, zip, country (opcionales) — se guardan en el JSON de address.
#   metadata (opcional) — cualquier valor serializable en JSON.
#   group (opcional) — array de cadenas con los UUID de grupos de contactos.
#   marketing_opt_in (opcional, booleano) — true registra el consentimiento de marketing en el contacto (registro de consentimiento del RGPD, source: api); false registra una baja. Omítelo para no modificar el consentimiento.
# Respuestas: 200 éxito { statusCode, id, message }; 400 error de validación; 403 suscripción inactiva o límite de contactos alcanzado.
# Acepta una cabecera Idempotency-Key (consulta Antes de empezar).

curl -X POST \
https://whapier.com/api/contacts \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "first_name": "Ana",
    "last_name": "Pop",
    "email": "ana@example.com",
    "group": [
        "d746e4c5-db24-4fb2-be03-590421344d69"
    ],
    "marketing_opt_in": true
}'

# contacts (obligatorio, de 1 a 500 objetos) con los campos de Añadir contacto por fila. Una fila cuyo phone ya existe en el espacio de trabajo se actualiza con los campos presentes (como hace Editar contacto); un número nuevo se crea.
# Cada fila va por su cuenta: una fila errónea falla sola y las demás pasan. Respuesta: { statusCode, created, updated, failed: [ { index, phone, errors } ], limit_reached, message }.
# La creación se detiene en el límite de contactos del plan: limit_reached pasa a true y las filas que no cupieron aparecen en failed. Las actualizaciones nunca cuentan para el límite. Acepta una cabecera Idempotency-Key.

curl -X POST \
https://whapier.com/api/contacts/bulk \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "contacts": [
        {
            "phone": "+40721000001",
            "first_name": "Ana",
            "last_name": "Pop",
            "email": "ana@example.com"
        },
        {
            "phone": "0721 000 002",
            "first_name": "Ion",
            "group": [
                "d746e4c5-db24-4fb2-be03-590421344d69"
            ]
        },
        {
            "phone": "not-a-phone",
            "first_name": "Nobody"
        }
    ]
}'

# Los mismos campos JSON que en Añadir contacto. {uuid} en la ruta es el id del contacto que se devolvió al crearlo.
# phone es opcional en una actualización; si lo cambias, el nuevo número no puede pertenecer a otro contacto (400 duplicado).
# Se permite actualizar con el mismo phone que ya tiene este contacto.
# Los campos que no envíes conservan su valor; envía un campo como null o "" para vaciarlo. Las claves de metadata que envíes se fusionan con las guardadas, y las demás se conservan.
# marketing_opt_in (opcional, booleano) — true registra el consentimiento de marketing (source: api), false registra una baja; si se omite, el consentimiento no cambia.
# 404 cuando el uuid es desconocido, está eliminado o pertenece a otro espacio de trabajo.

curl -X PUT \
https://whapier.com/api/contacts/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "first_name": "Ana",
    "last_name": "Popescu",
    "metadata": {
        "plan": "platinum"
    }
}'

# Elimina el contacto de forma lógica (soft delete); desaparece de todas las listas a la vez. 404 cuando el uuid es desconocido o ya está eliminado.
# Respuesta: { statusCode, id, message }.

curl -X DELETE \
https://whapier.com/api/contacts/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Parámetros de consulta opcionales: ?page=1&per_page=10 (per_page máx. 100).
# Cada grupo: uuid, name, contacts_count (miembros activos), created_at, updated_at.

curl -X GET \
"https://whapier.com/api/contact-groups?page=1&per_page=10" \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# name (obligatorio) debe ser único entre los grupos de la organización (400 si ya existe).
# Respuesta: { statusCode, id, message }. Acepta una cabecera Idempotency-Key.

curl -X POST \
https://whapier.com/api/contact-groups \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "name": "Lead 5"
}'

# El mismo cuerpo que en Añadir grupo de contactos. 404 para un uuid desconocido.

curl -X PUT \
https://whapier.com/api/contact-groups/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "name": "Lead 5"
}'

# Elimina el grupo y sus pertenencias; los contactos en sí se conservan. 404 para un uuid desconocido.

curl -X DELETE \
https://whapier.com/api/contact-groups/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Parámetros de consulta opcionales: ?page=1&per_page=10 (per_page máx. 100).
# Cada respuesta: uuid, name, trigger, match_criteria, response_type, response (el texto, o null para multimedia), file (name, url) o null, created_at, updated_at.

curl -X GET \
"https://whapier.com/api/canned-replies?page=1&per_page=10" \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Cuerpo: name y trigger (máx. 255), match_criteria (exact match | contains), response_type (text | image | audio), response.
# Para text, response es la respuesta (máx. 4096). Para image o audio envía multipart/form-data con el archivo como response (png/jpg hasta 5 MB; mp3/aac/ogg/amr/opus/m4a hasta 16 MB); sin archivo la petición es un 400.
# Respuesta: { statusCode, id, message }. 403 cuando se alcanza el límite de respuestas automáticas del plan. Acepta una cabecera Idempotency-Key.

curl -X POST \
https://whapier.com/api/canned-replies \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "name": "About Us",
    "trigger": "what do you do?",
    "match_criteria": "contains",
    "response_type": "text",
    "response": "We sell shoes"
}'

# Los mismos campos que en Añadir respuesta automática. Una actualización sin archivo conserva el multimedia que ya tiene. 404 para un uuid desconocido.

curl -X PUT \
https://whapier.com/api/canned-replies/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "name": "About Us",
    "trigger": "what do you do?",
    "match_criteria": "contains",
    "response_type": "text",
    "response": "We sell shoes and clothes"
}'

# 404 para un uuid desconocido. Respuesta: { statusCode, id, message }.

curl -X DELETE \
https://whapier.com/api/canned-replies/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Devuelve el uuid de cada línea (úsalo como whatsapp_connection en /api/send). No incluye ids internos de la base de datos.
# Cada fila: uuid, type, name, phone, display_phone_number y, para una línea de WhatsApp Business, verified_name y number_status. 403 cuando no hay ninguna línea conectada.

curl -X GET \
https://whapier.com/api/whatsapp-connections \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Opcional: whatsapp_connection (UUID de GET /api/whatsapp-connections). Omítelo para usar la línea predeterminada de la organización.
# phone (obligatorio) — en cualquier formato; se normaliza a E.164 con el país de la organización. Un número nuevo se convierte en contacto (first_name, last_name, email opcionales).
# message (obligatorio, máx. 4096); header y footer (opcionales, máx. 60); buttons (opcional, hasta 3 de { id, title }).
# Los mensajes de texto libre necesitan una ventana de 24 horas abierta: 422 cuando el último mensaje del cliente tiene más de un día. 403: suscripción, límite del plan, cupo diario de prueba o cuenta en revisión.
# Respuesta: 200 { statusCode, data: { success, data: { chat: { uuid, wam_id, status, type, created_at, contact } } } }. Un rechazo de WhatsApp es un 200 con data.success false y data.data.error en /api; un HTTP 422 en /api/v2.
# Acepta una cabecera Idempotency-Key.

curl -X POST \
https://whapier.com/api/send \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "message": "Hello Ana, how are you?",
    "whatsapp_connection": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "header": "Example Shoes",
    "footer": "Reply STOP to opt out",
    "buttons": [
        {
            "id": "yes",
            "title": "Fine"
        },
        {
            "id": "no",
            "title": "Not well"
        }
    ]
}'

# Opcional: whatsapp_connection (UUID de GET /api/whatsapp-connections). Omítelo para usar la línea predeterminada de la organización.
# media_type (image | video | audio | document | sticker); media_url (https, un host público; se comprueba con una petición HEAD contra los límites de tamaño y tipo de WhatsApp - 400 con el motivo en caso contrario); caption (opcional, no para audio); file_name (obligatorio para document).
# Las mismas comprobaciones y respuesta que Enviar mensaje.

curl -X POST \
https://whapier.com/api/send/media \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "media_type": "image",
    "media_url": "https://cdn.example.com/offers/october.jpg",
    "caption": "Our October offers"
}'

# Opcional: "whatsapp_connection": "<uuid>" para una línea WABA concreta (UUID de GET /api/whatsapp-connections).
# template.name y template.language ("en" o { "code": "en" }) son obligatorios; components sigue la forma propia de WhatsApp (header, body, parámetros de botones).
# Funciona fuera de la ventana de 24 horas. A un contacto que se dio de baja (STOP) no se le envía una plantilla MARKETING: 422. Las plantillas de utilidad y de autenticación sí se envían.
# Las mismas comprobaciones y respuesta que Enviar mensaje.

curl -X POST \
https://whapier.com/api/send/template \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "template": {
        "name": "order_update",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                        "type": "text",
                        "text": "48213"
                    }
                ]
            },
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Ana"
                    },
                    {
                        "type": "text",
                        "text": "48213"
                    },
                    {
                        "type": "date_time",
                        "date_time": {
                            "fallback_value": "October 7, 2026"
                        }
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "url",
                "index": "0",
                "parameters": [
                    {
                        "type": "text",
                        "text": "48213"
                    }
                ]
            }
        ]
    }
}'

# latitude (de -90 a 90) y longitude (de -180 a 180) obligatorios; name y address opcionales.
# Las mismas comprobaciones y respuesta que Enviar mensaje.

curl -X POST \
https://whapier.com/api/send/location \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "latitude": 46.77120000000000032969182939268648624420166015625,
    "longitude": 23.623599999999999710098563809879124164581298828125,
    "name": "Example Shoes",
    "address": "Str. Memorandumului 12, Cluj-Napoca"
}'

# contacts (de 1 a 10 tarjetas) con la forma contacts[] de WhatsApp: name.formatted_name obligatorio; phones[], emails[], addresses[], org opcionales.
# Las mismas comprobaciones y respuesta que Enviar mensaje.

curl -X POST \
https://whapier.com/api/send/contacts \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "contacts": [
        {
            "name": {
                "formatted_name": "Example Shoes Support",
                "first_name": "Support"
            },
            "phones": [
                {
                    "phone": "+40700000000",
                    "type": "WORK"
                }
            ],
            "emails": [
                {
                    "email": "support@example.com",
                    "type": "WORK"
                }
            ]
        }
    ]
}'

# message_id (el wam_id del mensaje al que se reacciona) y emoji (obligatorio; "" quita la reacción).
# Las mismas comprobaciones y respuesta que Enviar mensaje.

curl -X POST \
https://whapier.com/api/send/reaction \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "message_id": "wamid.HBgMNDA3MjEwMDAwMDEVAgARGBI5QkY2RkE3RDlCMjc2RjI2QkEA",
    "emoji": "👍"
}'

# message (obligatorio, máx. 1024): el texto que se muestra encima del botón "Enviar ubicación".
# Las mismas comprobaciones y respuesta que Enviar mensaje.

curl -X POST \
https://whapier.com/api/send/location-request \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "message": "Where should we deliver?"
}'

# message (obligatorio, máx. 1024): pide a un usuario de WhatsApp que solo tiene nombre de usuario que comparta su número de teléfono.
# Las mismas comprobaciones y respuesta que Enviar mensaje.

curl -X POST \
https://whapier.com/api/send/request-contact-info \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "message": "Could you share your number so we can call you back?"
}'

# message (obligatorio, máx. 1024) y cards (de 2 a 10): header { type: image | video, link } obligatorio; body (máx. 160), url_button { text, url } y quick_replies (hasta 3 de { id, title }) opcionales.
# Las mismas comprobaciones y respuesta que Enviar mensaje.

curl -X POST \
https://whapier.com/api/send/carousel \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "phone": "+40721000001",
    "message": "Our new arrivals",
    "cards": [
        {
            "header": {
                "type": "image",
                "link": "https://cdn.example.com/shoes/1.jpg"
            },
            "body": "Runner, 89 EUR",
            "url_button": {
                "text": "See it",
                "url": "https://example.com/shoes/1"
            }
        },
        {
            "header": {
                "type": "image",
                "link": "https://cdn.example.com/shoes/2.jpg"
            },
            "body": "Trail, 119 EUR",
            "quick_replies": [
                {
                    "id": "trail",
                    "title": "Tell me more"
                }
            ]
        }
    ]
}'

# contact (obligatorio): el uuid o el phone del contacto (normalizado con el país de la organización).
# 200 { statusCode, success: true, message }; 404 flujo o contacto desconocido; 422 flujo no publicado; 409 el contacto ya está en una sesión de flujo.
# Todo lo que envíe el flujo está sujeto a la ventana de 24 horas salvo que use nodos de plantilla.

curl -X POST \
https://whapier.com/api/flows/{{uuid}}/start \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "contact": "+40721000001"
}'

# Opcional: ?page=1&per_page=10&search=
# Cada campaña: uuid, name, status, scheduled_at, created_at, template (uuid, name, language, category, status), whatsapp_connection (uuid, name, type), audience (type: all | group | segment, uuid, name), counts (contacts, sent, delivered, read, failed).

curl -X GET \
"https://whapier.com/api/campaigns?page=1&per_page=10" \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Úsalo cuando whatsapp_connection sea una línea de WhatsApp Cloud (WABA) de GET /api/whatsapp-connections.
#
# REQUISITOS PREVIOS
# - template: UUID de una fila de GET /api/templates (de la organización), NO la cadena con el nombre público de la plantilla.
# - Ajusta el número de variables a tu plantilla aprobada: abre los metadatos de la plantilla en la interfaz o en Meta; BODY usa {{1}}, {{2}}, … en orden.
# - Debes enviar un parámetro de cuerpo por cada marcador de BODY, en el mismo orden. Un número que no coincida con la plantilla aprobada se rechaza de antemano (422), no lo rechaza WhatsApp después.
#
# NOTAS SOBRE LOS CAMPOS
# - contacts: "all" o el uuid de un grupo de contactos; o segment: el uuid de un segmento guardado (uno de los dos, no ambos). send_immediately: true, o scheduled_at (una fecha, leída como UTC).
# - header: objeto opcional; si se omite equivale a { "format": "TEXT", "parameters": [] }.
# - body: usa body.parameters[] para las variables. Formato de la API (recomendado): { "type": "text", "value": "literal for {{1}}" } por cada hueco.
#   Alternativa (como en el panel): { "selection": "static", "value": "..." } o { "selection": "dynamic", "value": "first name" } (asigna campos del contacto).
# - footer / buttons: opcionales; usa [] o {} si no se usan. Las plantillas con variables de URL o de respuesta rápida necesitan buttons[] con la misma forma que el formulario de campaña de la web.
# - Cabecera multimedia (IMAGE|VIDEO|DOCUMENT): header.parameters[] con type (IMAGE|VIDEO|DOCUMENT), "selection": "link", "value": "https://..." (URL pública; la API no puede subir archivos).
#
# RESPUESTA: 200 { "statusCode": 200, "uuid": "...", "message": "..." }. Consulta GET /api/campaigns/{uuid} para el informe y GET /api/campaigns/{uuid}/logs para el estado por destinatario, o suscríbete al webhook campaign.finished.
# 403 cuando se alcanza el límite de campañas del plan. Acepta una cabecera Idempotency-Key.

curl -X POST \
https://whapier.com/api/campaigns \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "name": "Billing reminder blast",
    "whatsapp_connection": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "contacts": "all",
    "send_immediately": true,
    "template": "281a3383-985c-4084-bcb0-9ec523c952de",
    "header": {
        "format": "TEXT",
        "parameters": []
    },
    "body": {
        "parameters": [
            {
                "type": "text",
                "value": "Ana"
            },
            {
                "type": "text",
                "value": "48213"
            },
            {
                "type": "text",
                "value": "7 October 2026"
            }
        ]
    },
    "footer": {},
    "buttons": []
}'

# El objeto campaña de Listar campañas más report: counts (contacts, sent, delivered, read, failed, pending), failure_reasons (code, title, count - los diez más frecuentes), started_at, finished_at (null hasta que la campaña termina), paused_reason, paused_detail y paused_at (null salvo que el estado sea paused).
# paused_reason es user (pausada desde el panel o la API), admin, failing, failure_rate o quality (pausada por la plataforma; paused_detail explica por qué). 404 para una campaña desconocida.

curl -X GET \
https://whapier.com/api/campaigns/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Sin cuerpo. Solo una campaña scheduled u ongoing puede pausarse: 409 en caso contrario, con el estado en que está la campaña. Los registros se quedan como están y reanudar los retoma.
# Respuesta: { statusCode, status, message } - status es el nuevo estado de la campaña. 404 para una campaña desconocida.

curl -X POST \
https://whapier.com/api/campaigns/{{uuid}}/pause \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{}'

# Sin cuerpo. Solo una campaña paused puede reanudarse: 409 en caso contrario. Una campaña pausada antes de su hora vuelve a scheduled; una pausada durante el envío vuelve a ongoing.
# Respuesta: { statusCode, status, message }. 404 para una campaña desconocida.

curl -X POST \
https://whapier.com/api/campaigns/{{uuid}}/resume \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{}'

# Sin cuerpo. Una campaña scheduled, ongoing o paused puede cancelarse: 409 en caso contrario. Lo que no se envió queda sin enviar; el informe sigue mostrando a quién se llegó.
# Respuesta: { statusCode, status, message }. 404 para una campaña desconocida.

curl -X POST \
https://whapier.com/api/campaigns/{{uuid}}/cancel \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{}'

# Opcional: ?page=1&per_page=10&search= (busca por nombre o teléfono del contacto).
# Cada fila: contact (uuid, phone, first_name, last_name), status, message (uuid, wam_id, status) o null, error (code, title, reason) o null, retry_count, created_at, updated_at. 404 para una campaña desconocida.

curl -X GET \
"https://whapier.com/api/campaigns/{{uuid}}/logs?page=1&per_page=10" \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Parámetros de consulta opcionales: ?page=1&per_page=10 (per_page máx. 100).
# Cada plantilla: uuid, name, language, category, status, components (tal como los aprobó WhatsApp), variables (header, body, buttons: cuántos marcadores admite cada parte), rejection (por qué se rechazó, o null), quality_score, updated_at.

curl -X GET \
"https://whapier.com/api/templates?page=1&per_page=10" \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# El objeto plantilla de Listar plantillas más example_payload: un cuerpo completo para POST /api/send/template con un parámetro por marcador (los ejemplos con los que se envió la plantilla, o un valor que nombra la posición), un enlace para una cabecera multimedia y un sufijo por cada botón URL con variable.
# Consulta opcional: whatsapp_connection (el uuid de una línea) cuando la misma plantilla existe en varias líneas. 404 para un uuid desconocido.

curl -X GET \
https://whapier.com/api/templates/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# name (letras minúsculas, dígitos y guiones bajos), category (MARKETING | UTILITY) y language (un código de idioma de Meta como en o pt_BR) son obligatorios; whatsapp_connection (el uuid de una línea de WhatsApp Business) es opcional - si no, la línea por defecto.
# header (opcional): { format: TEXT, text (máx. 60, un solo {{1}} permitido), examples } o { format: IMAGE | VIDEO | DOCUMENT, media_url: un enlace https público a un archivo de ejemplo }.
# body.text (obligatorio, máx. 1024, marcadores {{1}}, {{2}}, ...) con body.examples, uno por marcador; footer (opcional, máx. 60); buttons (opcional, hasta 10): { type: QUICK_REPLY | URL | PHONE_NUMBER | COPY_CODE, text, url, phone_number, example }.
# Respuesta: 200 { statusCode, uuid, status, message } - status es PENDING hasta que Meta la revisa (el webhook template.status.update te avisa). 400 con el motivo de Meta cuando Meta la rechaza; las plantillas AUTHENTICATION aún no pueden enviarse por la API. Una clave sandbox no puede enviar (403). Acepta una cabecera Idempotency-Key.

curl -X POST \
https://whapier.com/api/templates \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "name": "order_update",
    "category": "UTILITY",
    "language": "en",
    "header": {
        "format": "TEXT",
        "text": "Order {{1}}",
        "examples": [
            "48213"
        ]
    },
    "body": {
        "text": "Hi {{1}}, your order {{2}} ships on {{3}}.",
        "examples": [
            "Ana",
            "48213",
            "October 7"
        ]
    },
    "footer": "Example Shoes",
    "buttons": [
        {
            "type": "URL",
            "text": "Track",
            "url": "https://example.com/track/{{1}}",
            "example": "48213"
        },
        {
            "type": "QUICK_REPLY",
            "text": "Stop updates"
        }
    ]
}'

# Sin cuerpo. Descarga de Meta las plantillas de cada línea de WhatsApp Business, como hace el botón de actualizar del panel, para que una plantilla cambiada en Meta Business Manager aparezca también aquí.
# Respuesta: { statusCode, synced, message } - synced es cuántas plantillas se añadieron o cambiaron. Una clave sandbox no puede sincronizar (403); 400 cuando Meta rechazó la petición.

curl -X POST \
https://whapier.com/api/templates/sync \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{}'

# Cada fila: uuid, url, events, secret_preview (los últimos seis caracteres del secreto de firma), created_at, updated_at. El secreto completo se muestra una sola vez, en la respuesta de Añadir webhook.
# 403 cuando el módulo Webhooks no está en el plan.

curl -X GET \
https://whapier.com/api/webhooks \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Cada evento que un webhook puede recibir: data (name, description). La página Webhooks del panel lee el mismo catálogo.
# Una entrega es { event, data }; la forma de data por evento está en Antes de empezar > Webhooks, y POST /api/webhooks/{uuid}/test entrega un ejemplo de cualquiera de ellos.

curl -X GET \
https://whapier.com/api/webhooks/events \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# url (obligatorio, https, único por organización) y events (obligatorio, uno o más nombres de GET /api/webhooks/events).
# Respuesta: { statusCode, uuid, secret, message } - la única vez que se devuelve el secreto completo; guárdalo para comprobar X-Whapier-Signature. Acepta una cabecera Idempotency-Key.

curl -X POST \
https://whapier.com/api/webhooks \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "url": "https://example.com/hooks/whapier",
    "events": [
        "message.received",
        "message.status",
        "campaign.finished"
    ]
}'

# Mismo cuerpo que Añadir webhook. La lista events sustituye a la guardada; el secreto se mantiene. 404 para un uuid desconocido.

curl -X PUT \
https://whapier.com/api/webhooks/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "url": "https://example.com/hooks/whapier",
    "events": [
        "message.received",
        "message.status"
    ]
}'

# Elimina el endpoint y sus suscripciones; ya no se le entrega nada. Respuesta: { statusCode, uuid, message }. 404 para un uuid desconocido.

curl -X DELETE \
https://whapier.com/api/webhooks/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# event (obligatorio): un nombre de GET /api/webhooks/events. La carga de ejemplo se envía por POST a la url como { event, data, test: true }, firmada con el secreto en X-Whapier-Signature.
# Respuesta: { statusCode, event, delivered, http_status, message } - delivered es false con el estado con que respondió tu endpoint, o http_status null cuando no se pudo alcanzar. 404 para un uuid desconocido.

curl -X POST \
https://whapier.com/api/webhooks/{{uuid}}/test \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "event": "message.status"
}'

# Consulta opcional: status (sent | delivered | read | failed | accepted | played), direction (inbound | outbound), since y until (fechas, UTC), contact (el uuid de un contacto), campaign (el uuid de una campaña: los mensajes que produjo), wam_id (un mensaje por su id de WhatsApp), api_key (el uuid de una clave, o current: los mensajes enviados con la clave que hace la petición), page, per_page (25 por defecto, máx. 100).
# Respuesta: { statusCode, data: [ message ], meta: { page, per_page, total, last_page } }. 404 cuando contact, campaign o api_key es desconocido.
# Un mensaje: uuid, wam_id, direction, status, type, content, created_at, delivered_at, read_at, failed_at, failure (code, title, reason, retryable) o null, pricing (category, model, billable, amount, currency, country), api_key (uuid, name) o null cuando no se envió por la API, contact (uuid, phone, first_name, last_name).
# content según type - text: body, header, footer, buttons (type, text); template: name, language, body; image, video, audio, document, sticker: caption, media (type, url, filename); interactive y button: text, payload (lo que pulsó el cliente); location: latitude, longitude, name, address; contacts: contacts (name, phones); reaction: emoji, wam_id.

curl -X GET \
"https://whapier.com/api/messages?status=failed&per_page=25" \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Los mismos objetos mensaje que Listar mensajes, para un solo contacto, de más reciente a más antiguo. Consulta opcional: per_page (25 por defecto, máx. 100), before (el uuid del mensaje más antiguo que ya tienes).
# Respuesta: { statusCode, data: [ message ], meta: { per_page, has_more, next_before } } - pasa next_before como before para obtener los mensajes anteriores. 404 para un contacto o un cursor desconocido.

curl -X GET \
"https://whapier.com/api/contacts/{{uuid}}/messages?per_page=25" \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# El mismo objeto de mensaje más history: una lista de { status, timestamp, recorded_at }, cada cambio de estado que WhatsApp notificó. 404 para un uuid desconocido.

curl -X GET \
https://whapier.com/api/messages/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Datos de la respuesta: plan (name, status, valid_until), limits (contacts, messages, campaigns: used, limit; limit null = ilimitado), trial_daily_messages (solo cuentas de prueba), messages_sent (today, last_7_days, last_30_days), estimated_cost (last_30_days: amount, currency), rate_limit (per_minute).

curl -X GET \
https://whapier.com/api/usage \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# Respuesta data: contact (uuid, phone, first_name, last_name), ticketing (si Ajustes > Tickets está activado), ticket (status, assigned_to: name, email; opened_at, waiting_since, resolved_at) o null, messages (uuid, wam_id, direction, type, text, status, created_at - los 50 más recientes, primero el más nuevo), next_before.
# Consulta opcional: before (el uuid del mensaje más antiguo que tienes) para los mensajes anteriores; 400 cuando el cursor no es un mensaje de este contacto. 404 para un contacto desconocido.

curl -X GET \
https://whapier.com/api/conversations/{{uuid}} \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Accept: application/json'

# user_email (obligatorio, admite null): el email de un miembro activo de la organización; null desasigna el ticket. Una conversación sin ticket recibe uno.
# Respuesta: { statusCode, data: ticket, message } con el ticket tal como lo muestra Obtener una conversación. 409 mientras el ticketing está desactivado; 422 cuando ningún miembro activo de la organización tiene ese email; 404 para un contacto desconocido.

curl -X POST \
https://whapier.com/api/conversations/{{uuid}}/assign \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "user_email": "maria@example.com"
}'

# Sin cuerpo. Resuelve el ticket (status closed, resolved_at fijado), como el botón de la bandeja de entrada. Respuesta: { statusCode, data: ticket, message }.
# 409 mientras el ticketing está desactivado; 404 para un contacto desconocido.

curl -X POST \
https://whapier.com/api/conversations/{{uuid}}/close \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{}'

# Sin cuerpo. Reabre un ticket cerrado (status open, resolved_at borrado); un ticket abierto se devuelve tal cual. Respuesta: { statusCode, data: ticket, message }.
# 409 mientras el ticketing está desactivado; 404 para un contacto desconocido.

curl -X POST \
https://whapier.com/api/conversations/{{uuid}}/reopen \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{}'

# note (obligatorio, máx. 5000): visible para los agentes en el hilo, nunca se envía al contacto. Funciona con el ticketing activado o desactivado.
# Respuesta: { statusCode, uuid, created_at, message }. 404 para un contacto desconocido. Acepta una cabecera Idempotency-Key.

curl -X POST \
https://whapier.com/api/conversations/{{uuid}}/notes \
-H 'Authorization: Bearer <YOUR_AUTHORIZATION_TOKEN>' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
    "note": "Customer called; wants the order delivered on Friday."
}'