Grupos

En esta página, nos ocuparemos de los diferentes puntos finales de grupos que puede utilizar para la gestión programática de grupos. Veremos cómo consultar, crear, actualizar y eliminar grupos.

El modelo de grupo

El modelo de grupo contiene toda la información sobre sus grupos.

Los grupos son estáticos o dinámicos. Los grupos dinámicos se crean en el dashboard con un filtro, por ejemplo todos los contactos de una ciudad determinada o todos los contactos que respondieron en los últimos 30 días. Sus miembros se determinan automáticamente y se recalculan justo antes de cada envío. Puede usar los grupos dinámicos como cualquier otro grupo, por ejemplo como destinatario, pero no puede añadir ni eliminar miembros a través de la API.

Propiedades

Name
id
Type
integer
Description
Identificador único del grupo.
Name
name
Type
string
Description
El nombre del grupo.
Name
members_count
Type
integer
Description
La cantidad de contactos que están en este grupo.
Name
created
Type
timestamp
Description
Momento de la creación del grupo.
Name
dynamic
Type
boolean
Description
true para grupos dinámicos cuyos miembros se derivan de un filtro. Sus miembros no se pueden modificar a través de la API.

{
    "id": 17923,
    "name": "Gruppe 1",
    "members_count": 543,
    "created": "2023-12-21 21:59:53",
    "dynamic": false
}

GET/api/groups

Listar todos los grupos

Este punto final le permite obtener una lista paginada de todos sus grupos. De forma predeterminada, se muestran un máximo de diez grupos por página.

Parámetros opcionales

Name
limit
Type
integer
Description
Limite la cantidad de grupos devueltos.
Name
offset
Type
integer
Description
El punto de inicio desde el cual se debe mostrar la lista.

Solicitud

GET

/api/groups

curl -G https://gateway.seven.io/api/groups \
    -H "X-Api-Key: SU_CLAVE_API" \
    -d limit=10

Respuesta

{
    "pagingMetadata": {
        "offset": 0,
        "count": 4,
        "total": 40,
        "limit": 30,
        "has_more": false
    },
    "data": [
        {
            "id": 17923,
            "name": "Gruppe 1",
            "members_count": 543,
            "created": "2023-12-21 21:59:53",
            "dynamic": false
        }
    ]
}

POST/api/groups

Crear grupo

Con este endpoint, puede crear un nuevo grupo.

Parámetros requeridos

Name
name
Type
string
Description
El nombre del grupo

Solicitud

POST

/api/groups

curl https://gateway.seven.io/api/groups \
    -H "X-Api-Key: SU_CLAVE_API" \
    -d "name=Eine neue Gruppe"

Respuesta

{
    "id": 17923,
    "name": "Eine neue Gruppe",
    "members_count": 0,
    "created": "2023-12-21 21:59:53",
    "dynamic": false
}

GET/api/groups/:id

Obtener un grupo

Con este endpoint, puede obtener un grupo proporcionando el ID del grupo. Puede encontrar qué propiedades pertenecen a los objetos de grupo en la lista arriba en esta página.

Solicitud

GET

/api/groups/17923

curl https://gateway.seven.io/api/groups/17923 \
    -H "X-Api-Key: SU_CLAVE_API"

Respuesta

{
    "id": 17923,
    "name": "Eine neue Gruppe",
    "members_count": 0,
    "created": "2023-12-21 21:59:53",
    "dynamic": false
}

PATCH/api/groups/:id

Actualizar un grupo

Con este endpoint, puede actualizar un grupo. Puede cambiar el nombre del grupo.

Parámetros opcionales

Name
name
Type
string
Description
El nombre del grupo.

Solicitud

PATCH

/api/groups/17923

curl -X PATCH https://gateway.seven.io/api/groups/17923 \
    -H "X-Api-Key: SU_CLAVE_API" \
    -d "name=Neuer Gruppenname"

Respuesta

{
    "id": 17923,
    "name": "Neuer Gruppenname",
    "members_count": 543,
    "created": "2023-12-21 21:59:53",
    "dynamic": false
}

DELETE/api/groups/:id

Eliminar grupo

Este punto final le permite eliminar grupos.

Parámetros opcionales

Name
delete_contacts
Type
boolean
Description
Indica si también se deben eliminar los contactos que son miembros de este grupo. No disponible para grupos dinámicos.

Solicitud

DELETE

/api/groups/17923

curl -X DELETE https://gateway.seven.io/api/groups/17923 \
    -H "X-Api-Key: SU_CLAVE_API" \
    -d "delete_contacts=false"