> For the complete documentation index, see [llms.txt](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://anunzi-ai.gitbook.io/anunzi-ia-documentation/api-de-anunzi/v1/campaigns.md).

# Campañas

Campañas de llamadas salientes. Base: `https://panel.anunzi.net/api/v1/campaigns/`.

| Método | Ruta                     | Descripción                                          |
| ------ | ------------------------ | ---------------------------------------------------- |
| `GET`  | `list.php`               | Lista las campañas de la cuenta.                     |
| `POST` | `create.php`             | Crea una campaña (en borrador).                      |
| `POST` | `add-contacts.php`       | Agrega contactos (lista, etiqueta o segmento).       |
| `POST` | `activate.php`           | Activa la campaña (la agenda y el motor la ejecuta). |
| `POST` | `pause.php`              | Pausa una campaña activa.                            |
| `GET`  | `stats.php?campaign_id=` | Estado y métricas por estado.                        |

***

## Flujo típico

**1. Crear**

```json
POST create.php
{ "name": "Reactivación septiembre", "agent_id": "agent_…", "timezone": "America/Argentina/Buenos_Aires",
  "allowed_hours": { "from": "09:00", "to": "20:00" }, "concurrency_limit": 3 }
```

Devuelve `{ "campaign_id": 123, "status": "draft" }`.

**2. Cargar contactos** — por lista explícita, por etiqueta o por segmento:

```json
POST add-contacts.php
{ "campaign_id": 123, "tag": "Reactivar" }
```

```json
{ "campaign_id": 123, "contacts": [ { "name": "Ana", "phone": "+54911..." } ] }
```

**3. Activar**

```json
POST activate.php
{ "campaign_id": 123 }
```

Devuelve la hora de agendado y cuántas tareas se crearon. Respeta la franja horaria y los días permitidos.

**4. Seguir**

`GET stats.php?campaign_id=123` → cantidad de contactos por estado (pendiente, en curso, completado, etc.). `POST pause.php` para pausar.