Referencia (endpoints)Atender una conversación

Mandar una tarjeta de contacto

Sirve para compartirle a un contacto una o más tarjetas de contacto desde uno de tus números, por ejemplo para pasarle el contacto de un vendedor o de soporte.

POST
/contacts/{contact}/message/contact-card

Permiso requerido: Contactos y conversaciones → Enviar

Si el límite de contactos activos (MAC) frena el envío, responde 429 con error = mac_lockout_24h o mac_limit_reached y sin Retry-After: reintentar no sirve hasta que sumes capacidad o empiece un ciclo nuevo. El envío no sale y no se guarda ningún mensaje ni tu client_reference: no queda nada en el historial del contacto. Detalle en «Errores y límites».

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

contact*string

Id opaco: un texto que empieza con ctc_. Se usa tal como llega; no se arma ni se interpreta.

Patrón^ctc_[A-Za-z0-9]{23}$

Cuerpo del pedido

application/json
  1. body
device_id*string

Id opaco: un texto que empieza con dev_. Se usa tal como llega; no se arma ni se interpreta.

Patrón^dev_[A-Za-z0-9]{23}$
contact_card_ids*array<>
Elementos1 <= items <= 5
client_reference?|
Patrón^[\x21-\x7E]{1,64}$
Largolength <= 64

Cuerpo de la respuesta

OK

application/json
  1. response
messages*array<>
curl -X POST "https://example.com/contacts/ctc_AAOzYSKDiqHT4hM8LdPB8Ut/message/contact-card" \  -H "Content-Type: application/json" \  -d '{    "device_id": "dev_Ac7Ku7iIZDXJTjdCu0UB1mX",    "contact_card_ids": [      "ctc_AAOzYSKDiqHT4hM8LdPB8Ut"    ]  }'
{  "messages": [    {      "id": "msg_As2pkZIkjmvC3nnoiFlYfDo",      "contact_id": "ctc_AAOzYSKDiqHT4hM8LdPB8Ut",      "device_id": "dev_Ac7Ku7iIZDXJTjdCu0UB1mX",      "direction": "outbound",      "type": "text",      "status": "sent",      "error": {        "code": 0,        "title": "string",        "reason": "string"      },      "client_reference": "string",      "created_at": "string",      "updated_at": "string"    }  ]}

Esto es lo que se copia para tu IA

Cargando…