Contactos
La base de contactos de la cuenta: crear, editar, borrar, registrar consentimiento,
unir duplicados e importar por lotes. Una API key restringida a algunos números solo
ve los contactos que tienen conversación en esos números, y recibe 403 en lo que es de
toda la base — exportar, importar, crear, borrar, unir, opt-in y las definiciones de
campos y tags.
GETListar contactosLa base de contactos, paginada. Todos los filtros se suman (Y).POSTCrear contactoCrea un contacto a partir de un teléfono o de un BSUID. El teléfono se normaliza a E.164 y se guarda sin el +; sin código de país, indica defaultCountry.POSTCrear o actualizar contactos por loteHasta 500 contactos por llamada, cada uno creado o actualizado por teléfono o BSUID. La respuesta es 200 aunque fallen filas: el resultado de cada una viene…POSTSincronizar los contactos de un sitioLos clientes de un sitio conectado, hasta 500 por llamada. Es lo que llama el plugin de WordPress para traer los usuarios, clientes y leads del sitio — y…GETExportar contactos en CSVToda la base — o lo que seleccionen los filtros — en un CSV, sin paginación. Una columna por campo personalizado, después de las fijas. El archivo empieza…GETListar importacionesListar importacionesPOSTAbrir una importaciónUn registro que acompaña una importación grande hecha en varios lotes: envía su id en options.importId de cada POST /contacts/batch y los contadores se…GETConsultar una importaciónConsultar una importaciónPATCHCerrar una importaciónMarca la importación como completed o failed. Solo una importación todavía en processing se puede cerrar.GETConsultar un contactoEl contacto, con las filas de la lista de supresión que coinciden con su teléfono o BSUID.PATCHEditar un contactoUn campo ausente queda igual; null lo borra. attributes es un parche sobre los valores guardados, y tagIds es el conjunto completo de etiquetas. El…DELBorrar un contactoBorra el contacto de forma definitiva, con sus conversaciones, mensajes, etiquetas e historial — es la solicitud de supresión de datos. Las filas de la…POSTRegistrar opt-inRegistra el consentimiento de marketing, con la evidencia de cómo se obtuvo. Saca el contacto de la lista de supresión solo cuando el motivo era una baja…POSTRegistrar bajaQuita el consentimiento y pone el teléfono y el BSUID del contacto en la lista de supresión. Dispara contact.optedout.POSTUnir contactos duplicadosEl contacto de la ruta sobrevive; duplicateId se borra después de mover sus conversaciones, etiquetas, historial y campañas. En los campos, vale el del…GETHistorial del contactoLo que pasó con el contacto, de lo más reciente a lo más antiguo: creación, ediciones, etiquetas, consentimiento, uniones y clics en campañas.GETVentana de atención (24 h) del contactoSi un mensaje libre (fuera de plantilla) todavía llega al contacto, número por número. La ventana se abre cuando el contacto escribe y dura 24 h desde su…GETExportar los datos de un contactoTodo lo que la cuenta guarda sobre el contacto, en un JSON descargable — la solicitud de acceso a los datos. Hasta 10.000 mensajes por conversación.