Enviar Mensajes

Enviar Carrusel

Envía un carrusel de tarjetas con imagen y botones de acción. Cada elemento del array `carousel` representa una tarjeta con `text`, `image` y `buttons: [{type,text,id}]`.

POSThttps://api.zapzapapi.com/api/v1/{instanceId}/send/carousel

Autenticación con los encabezados x-api-key y x-api-secret.

Parámetros

Nombre	Tipo	Dónde	Obligatorio	Descripción
`number`	text	cuerpo	Sí	Número (con código de país)
`text`	textarea	cuerpo	Sí	Texto principal del mensaje
`carousel`	json	cuerpo	Sí	Tarjetas (array JSON)
`delay`	number	cuerpo	No	Delay (ms)
`digitando`	select	cuerpo	No	Muestra un indicador automático de "escribiendo..." proporcional al tamaño del mensaje antes de enviarlo. Activado por defecto (humaniza y reduce el riesgo de bloqueo). Envía false para desactivarlo y responder más rápido. La respuesta sigue siendo síncrona.

Ejemplo de solicitud

curl

curl -X POST "https://api.zapzapapi.com/api/v1/{instanceId}/send/carousel" \
  -H "x-api-key: TU_API_KEY" \
  -H "x-api-secret: TU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"number":"5511999999999","text":"Confira nossas opções:","carousel":[{"text":"Produto 1","image":"https://exemplo.com/img.jpg","buttons":[{"type":"REPLY","text":"Quero!","id":"quero"}]}]}'

Node.js

const res = await fetch("https://api.zapzapapi.com/api/v1/{instanceId}/send/carousel", {
  method: "POST",
  headers: {
    "x-api-key": "TU_API_KEY",
    "x-api-secret": "TU_API_SECRET",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "number": "5511999999999",
    "text": "Confira nossas opções:",
    "carousel": [
      {
        "text": "Produto 1",
        "image": "https://exemplo.com/img.jpg",
        "buttons": [
          {
            "type": "REPLY",
            "text": "Quero!",
            "id": "quero"
          }
        ]
      }
    ]
  }),
});
console.log(await res.json());

Python

import requests

res = requests.post(
    "https://api.zapzapapi.com/api/v1/{instanceId}/send/carousel",
    headers={"x-api-key": "TU_API_KEY", "x-api-secret": "TU_API_SECRET"},
    json={"number":"5511999999999","text":"Confira nossas opções:","carousel":[{"text":"Produto 1","image":"https://exemplo.com/img.jpg","buttons":[{"type":"REPLY","text":"Quero!","id":"quero"}]}]},
)
print(res.json())

Ejemplo de respuesta

JSON

{
  "messageId": "ABCDEF123456",
  "status": "sent"
}

Los valores son ilustrativos; los campos siguen el formato real de la respuesta.

Otros endpoints de esta categoría

Ver la referencia completa

Consigue tus claves de API

Crea tu cuenta, conecta un número en minutos y empieza a usar la API. R$15 por número activo/mes, con un crédito de bienvenida al crear la cuenta, sujeto a la campaña vigente.

Crear cuenta gratis Ver la documentación