external_id: ID externo del contacto para integraciones
Usa external_id para enlazar un contacto con su registro en tu ERP, e-commerce u otro sistema y evitar duplicados al sincronizar.
Que es el external_id
El campo external_id guarda el identificador que un contacto ya tiene en otro sistema tuyo (tu ERP, tu e-commerce, otro CRM, una base propia). Es un texto libre de hasta 255 caracteres que viaja junto a la ficha del contacto en Omnifox y sirve para enlazar ese contacto con su registro original en tu plataforma.
No lo usa la mensajeria ni Meta; es exclusivamente para integraciones que tu construyas con la API REST de Omnifox. Esta indexado, por lo que buscar o deduplicar por external_id es rapido.
Cuando usarlo
- Sincronizas contactos entre Omnifox y un sistema externo y necesitas saber cual es cual sin depender del telefono o el correo (que pueden cambiar).
- Quieres que tu integracion sea idempotente: reenviar el mismo contacto no crea duplicados.
Como guardarlo via API
El external_id se acepta al crear o actualizar un contacto, y como clave en el upsert.
1. Crear con external_id:
POST /api/v1/contacts
{
"first_name": "Alex",
"phone": "+593990000000",
"external_id": "erp-00482"
}
2. Upsert (crea o actualiza segun una clave unica):
POST /api/v1/contacts/upsert
{
"unique_by": ["external_id"],
"external_id": "erp-00482",
"first_name": "Alex",
"email": "[email protected]"
}
Con unique_by: ["external_id"], Omnifox busca en el workspace actual un contacto con ese external_id. Si encuentra exactamente uno, lo actualiza; si no hay ninguno, lo crea. Puedes combinar claves (["phone","external_id"]), pero si distintas claves apuntan a contactos diferentes, la API responde 409 (ambiguo) para que no fusiones por error.
Verificacion
- Tras el upsert, vuelve a llamarlo con los mismos datos: la respuesta debe devolver el mismo id de contacto y no crear uno nuevo.
- En Contactos, abre la ficha y confirma que los datos se actualizaron en lugar de duplicarse.
Si no funciona
- Se crean duplicados: revisa que envias
unique_byy que el external_id sea identico (sin espacios ni mayusculas distintas). El valor se compara tal cual. - Recibo 409 ambiguo: dos contactos del workspace ya tienen claves que chocan (p. ej. uno con ese telefono y otro con ese external_id). Resuélvelo fusionando o limpiando antes de reintentar.
- El external_id es nulo entre workspaces: recuerda que cada workspace tiene su propia base; el external_id solo es unico dentro del workspace donde lo guardaste.
Tips
- Usa un prefijo en el valor (
erp-,shop-) para saber de un vistazo de que sistema viene. - Manten el external_id estable: si cambia en tu sistema origen, perderas el enlace y podrias duplicar.
Articulos relacionados
Artículos relacionados
-
Cómo importar contactos desde un archivo CSV
Sube tu lista de contactos en minutos mapeando las columnas de tu CSV a los campos del CRM.
-
Gestionar contactos y el CRM
En Omnifox cada conversacion crea un contacto. Aprende a usar campos personalizados, etiquetas, el pipeline de oportunidades y la linea de tiempo 360 del contacto.
-
Guía completa del CRM
El CRM a fondo, en 46 capítulos: pipeline, oportunidades, ficha de la venta, pendientes, tablero y meta, configuración, ficha del contacto, contactos, importar, formularios, chat, IA y flujos.
-
Campos personalizados de contactos
Crea campos a la medida de tu negocio para guardar exactamente la información que necesitas de cada contacto.
-
El pipeline de ventas y las oportunidades (deals)
Visualiza y gestiona tu proceso comercial con un tablero de etapas y tarjetas de oportunidad.