Ingresar
DocumentaciónGuíasReferenciaWebhooksRecursos
Contactos

Listar los contactos de un número

Sirve para listar los contactos asociados a uno de tus números conectados, útil si manejás varios números y querés separar la base por cada uno.

GET
/devices/{device}/contacts

Permiso requerido: conversations:read

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

device*integer

Parámetros de consulta

perPage?integer
Rango1 <= value <= 100
Por defecto25

Cuerpo de la respuesta

OK

application/json
  1. response
data*array<>
links*
meta*
curl -X GET "https://example.com/devices/0/contacts"
{  "data": [    {      "id": 0,      "name": "string",      "email": "string",      "phone": "string",      "whatsapp_id": "string",      "whatsapp_username": "string",      "has_phone": true,      "country_code": "string",      "status": 0,      "image": "string",      "notes": "string",      "custom_fields": [        {          "id": 0,          "name": "string",          "description": "string",          "type": "string",          "value": "string",          "created_at": "string",          "updated_at": "string",          "contact_count": "string"        }      ],      "created_at": "2019-08-24T14:15:22Z",      "active_conversation": 0,      "favorite": 0,      "unread_messages": 0,      "manually_unread": true,      "last_message": {        "text": "string",        "file": "string",        "date": "string",        "type": "string",        "own": "string",        "deleted_at": "string",        "deleted_scope": "string"      },      "device_id": 0,      "adviser_id": 0,      "paused_at": "string",      "mac_date": "string",      "is_mac_inactive": true,      "ai_assistant_name": "string",      "stage_since": "string",      "is_stagnant": true,      "lead_score": {        "score": 0,        "signals_count": 0,        "category": "string",        "confidence": "string",        "disqualified": true,        "disqualified_at": "string",        "updated_at": "string"      },      "name_mismatch": [        null      ]    }  ],  "links": {    "first": "string",    "last": "string",    "prev": "string",    "next": "string"  },  "meta": {    "current_page": 0,    "from": 0,    "last_page": 0,    "links": [      {        "url": "string",        "label": "string",        "active": true      }    ],    "path": "string",    "per_page": 0,    "to": 0,    "total": 0  }}

Ver la ventana de 24 horas de un contacto GET

Usalo antes de escribirle a un contacto para saber si su ventana de 24 horas de Meta está abierta en un número, y así decidir si podés mandar un mensaje libre o necesitás una plantilla.

Eliminar contactos POST

Usalo para borrar contactos en bloque: por IDs, por filtros (etiquetas, campos personalizados, país, fecha de alta) o todos. Ideal para limpiezas masivas de la base.