Escribe en WhatsApp mediante nuestras API

Esta funcionalidad permite que tu software de gestión o cualquier otro software externo se comunique directamente con tus clientes en WhatsApp, utilizando Quoting24 como puente.

En palabras sencillas, gracias a esta integración es posible enviar mensajes y documentos de forma automática, sin tener que abrir la aplicación de Quoting24 y sin tener que copiar y pegar manualmente los datos.

Qué es posible hacer?

Utilizando esta conexión, tu sistema de gestión puede realizar tres acciones principales de una sola vez:

Enviar un mensaje de texto

Puedes escribir al cliente cualquier información: un aviso de mercancía lista, una confirmación de pedido o un simple saludo.

Enviar archivos y documentos (PDF, imágenes, etc.)

Junto con el texto, puedes adjuntar archivos. Muy útil, por ejemplo, para enviar el PDF de un presupuesto o de una factura directamente en la chat de WhatsApp del cliente.

Cerrar automáticamente la solicitud (Ticket)

A menudo, cuando se envía un presupuesto o una confirmación, la operación puede considerarse concluida.

Es posible indicar al sistema que "archive" (cierre) inmediatamente la conversación después del envío del mensaje, para mantener limpia la lista de solicitudes abiertas en Quoting24 sin tener que hacerlo a mano.

Detalles técnicos para la integración

Hay un endpoint disponible para enviar mensajes a un contacto individual mediante WhatsApp Business API.

La autenticación se realiza mediante el header X-API-Key usando la clave API de tu tenant, disponible en la configuración de cuenta.

Enviar mensaje a un contacto

Endpoint: https://api.quoting24.com/webhook/sendmessage

Mensaje de texto:

curl --request POST \
  --url https://api.quoting24.com/webhook/sendmessage \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <la-tua-api-key>' \
  --data '{
    "tenant_id": "<il-tuo-tenant-id>",
    "phone_number": "+39123456789",
    "channel": "whatsapp-api",
    "message_content": {
      "text": "Ciao! Il tuo preventivo è pronto."
    },
    "auto_close_ticket": true
  }'

Mensaje con imagen o documento (URL público):

curl --request POST \
  --url https://api.quoting24.com/webhook/sendmessage \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <la-tua-api-key>' \
  --data '{
    "tenant_id": "<il-tuo-tenant-id>",
    "phone_number": "+39123456789",
    "channel": "whatsapp-api",
    "message_content": {
      "type": "file",
      "text": "In allegato il tuo preventivo.",
      "file": {
        "url": "https://esempio.com/preventivo.pdf",
        "name": "preventivo.pdf",
        "mime_type": "application/pdf"
      }
    },
    "auto_close_ticket": true
  }'

Parámetros message_content:

Campo	Tipo	Obligatorio	Descripción
`type`	`text` / `image` / `video` / `audio` / `file`	No, default `text`	Tipo de mensaje
`text`	stringa	No	Texto del mensaje o leyenda del archivo
`file.url`	stringa URL	Sí si `type` es distinto de `text`	URL público del archivo que se va a enviar
`file.name`	stringa	Sí si `type` es distinto de `text`	Nombre del archivo con extensión, por ejemplo `preventivo.pdf`
`file.mime_type`	stringa	Sí si `type` es distinto de `text`	Tipo MIME, por ejemplo `application/pdf` o `image/jpeg`

Parámetros principales:

Campo	Descripción
`tenant_id`	ID de tu tenant, disponible desde la configuración
`phone_number`	Número de teléfono del cliente con prefijo internacional, por ejemplo `+39123456789`
`channel`	`whatsapp-api` para WhatsApp Business API
`auto_close_ticket`	`true` para cerrar automáticamente el ticket después del envío

Nota: el archivo que se va a adjuntar debe ser accesible mediante una URL pública. Si el archivo procede de un software de gestión o de un sistema interno, asegúrate de que sea accesible desde internet antes de pasar su enlace a la API.

Nota operativa: el envío de mensajes sigue las reglas de Meta. Para iniciar conversaciones fuera de la ventana de asistencia de 24 horas pueden ser necesarios templates preaprobados.