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.
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».
httpAuthorizationBearer <clave>contact*stringId opaco: un texto que empieza con ctc_. Se usa tal como llega; no se arma ni se interpreta.
^ctc_[A-Za-z0-9]{23}$application/json- body
device_id*stringId opaco: un texto que empieza con dev_. Se usa tal como llega; no se arma ni se interpreta.
^dev_[A-Za-z0-9]{23}$contact_card_ids*array<>1 <= items <= 5client_reference?|^[\x21-\x7E]{1,64}$length <= 64OK
application/json- 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" } ]}Reenviar un mensaje POST
Úsalo para reenviar un mensaje de una conversación a otros contactos, eligiendo desde qué número sale cada envío; la respuesta indica el resultado por destino.
Etiquetas
Ver, crear, editar y borrar tus etiquetas, agregarlas a tus contactos y quitárselas, y ver los contactos que tienen una y las etiquetas de un contacto.