Saltar al contenido principal
POST
/
api
/
v1
/
messages
Send WhatsApp text message
curl --request POST \
  --url https://app.flowella.io/api/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "to": "+15551234567",
  "text": "Hello from Flowella API",
  "whatsappChannelId": "<string>"
}
'
{
  "id": "<string>",
  "conversationId": "<string>",
  "contactId": "<string>",
  "metaMessageId": "wamid.xxx"
}
Envía un mensaje de texto de WhatsApp a un destinatario. Para mensajes proactivos fuera de la ventana de 24 horas debes usar una plantilla aprobada con el endpoint de envío de plantillas.

​
Autenticación

Todas las solicitudes requieren la cabecera Authorization: Bearer <api_key> con una clave que empieza por el prefijo flo_.

​
Cuerpo de la solicitud

​
to
string
requerido
Número de teléfono del destinatario en formato E.164 o solo dígitos (entre 3 y 32 caracteres). El servidor lo normaliza automáticamente. Ejemplo: +34612345678.
​
text
string
requerido
Contenido del mensaje (de 1 a 4096 caracteres).
​
whatsappChannelId
string
Identidad de envío opcional. Si se omite, se usa el canal predeterminado de la organización.

​
Respuesta

​
id
string
requerido
ID interno del mensaje en Flowella.
​
conversationId
string
requerido
ID de la conversación en la que se encoló el mensaje.
​
contactId
string
requerido
ID del contacto destinatario.
​
metaMessageId
string
ID del mensaje devuelto por Meta (por ejemplo, wamid.xxx). Puede ser null si Meta aún no ha confirmado.

​
Errores

CódigoSignificado
400Error de validación o rechazo de Meta.
401Falta la clave de API o no es válida.
402Pago requerido: tu suscripción no cubre esta acción.
403Prohibido (por ejemplo, contacto dado de baja o Meta no conectado).
404Canal no encontrado.
429Limitado por tasa.

​
Ejemplo

curl -X POST https://app.flowella.io/api/v1/messages \
  -H "Authorization: Bearer flo_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+34612345678",
    "text": "Hola desde la API de Flowella"
  }'

Autorizaciones

​
Authorization
string
header
requerido

Organization API key (flo_…). Send as Authorization: Bearer <key>.

Cuerpo

application/json
​
to
string
requerido

E.164 or digits; normalized server-side.

Required string length: 3 - 32
Ejemplo:

"+15551234567"

​
text
string
requerido
Required string length: 1 - 4096
Ejemplo:

"Hello from Flowella API"

​
whatsappChannelId
string

Optional sending identity; defaults to org default channel.

Respuesta

Message accepted and stored

​
id
string
requerido
​
conversationId
string
requerido
​
contactId
string
requerido
​
metaMessageId
string | null
Ejemplo:

"wamid.xxx"