Contacts

Crea un contacto. Refleja DELETE /contacts/:id: también crea el suscriptor en Meteor CRM (uChat).

Crea el contacto y también el suscriptor en el CRM, no solo la fila: por eso es la contraparte exacta de DELETE /contacts/{contactId}. Para cargar muchos no lo llames en un bucle — POST /contacts/import hace el lote y sabe qué hacer con los repetidos.

Si el contacto ya existe. La deduplicación es por la identidad del canal (data.$user_ns + canal; en WhatsApp directo son los dígitos del teléfono), no por el teléfono a secas. Si ya hay un contacto con esa identidad y su teléfono coincide con el pedido (normalizado: 3001234567, +57 300 123 4567 y 573001234567 son el mismo), se devuelve ese contacto con created: false y matched_by: "user_ns", sin aplicarle nada del cuerpo — para cambiar sus datos usa PATCH /contacts/{contactId}. Si guarda otro teléfono, responde 409 contact_identity_conflict y no devuelve a nadie: nunca recibes a otra persona como si fuera la que pediste. Mira siempre created antes de etiquetar o actualizar: el código HTTP es 201 en los dos casos.

Nombre. Si mandas name sin first_name, data.$first_name queda con la primera palabra y, si tampoco mandas last_name, data.$last_name con el resto.

post/contacts

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/contacts
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Request body

channel_idnumber
emailstring email
first_namestring
genderstring
imagestring
last_namestring
namestring
phonestring

Response

El contacto. created: true si se creó; created: false (con matched_by) si ya existía con esta identidad en el canal y es la misma persona. Ambos casos responden 201.

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": {
    "app_url": "https://met.meteor.com.co/abrir/137/contacto/4821",
    "channel_id": 5,
    "channel_name": "WhatsApp Ventas",
    "channel_type": "whatsapp",
    "code": "K7F2QA",
    "collection_id": 137,
    "conversation_line_id": "606306225903622",
    "created": true,
    "created_at": "2026-07-30T04:12:33.120Z",
    "data": {
      "$name": "Ada Lovelace",
      "$phone": "+573001112233",
      "etapa": "Negociación"
    },
    "id": 4821,
    "line_attention_enabled": true,
    "matched_by": "user_ns"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.