# hecigo: middleware & integration lab

hecigo builds and runs the middleware layer between any two systems that need to
exchange data: business software, marketplaces, data warehouses, cloud
infrastructure, email, social channels, and custom automated workflows. That list
is not a limit. What matters is whether two systems can exchange data at all,
not what category they belong to.

Legal entity: HECIGO TECHNOLOGY CO., LTD. Based in Ho Chi Minh City, Vietnam.
Working languages: Vietnamese and English.

## What the middle layer does

- **Deduplication**: a unique key of the shape `source:type:id:version` admits
  the first copy of an event and rejects the replay, so a retried webhook does
  not become a second order.
- **No silent loss**: every event is written to an event log before delivery is
  attempted, retried with exponential backoff and jitter, and parked in a
  replayable dead-letter queue when the attempts run out. The DLQ raises an alert.
- **Reconciliation**: a scheduled pass compares source against target and
  reports discrepancies, so missing records surface on a schedule rather than at
  the end of a quarter.
- **Audit trail**: every transaction through the layer is queryable, showing what
  arrived, what was written, which attempt succeeded, and why an attempt failed.

Latency targets are agreed per project and measured at the middleware boundary,
conditional on both platforms responding within their normal range. We do not
publish a single number, because the number depends on the slower of the two
systems and on nothing we control.

## How an engagement runs

Four steps, each ending in a gate you are free to stop at.

1. **Integration discovery** (1-2 weeks). A written technical assessment:
   current and target data-flow maps, draft field mapping, API capability on both
   ends (webhooks, rate limits, pagination, latency), and a POC outline with
   acceptance criteria. The assessment is yours; take it to another vendor if you
   want.
2. **POC on real data** (one flow, 20-50 transactions). Measured against the
   acceptance criteria agreed before a line of code is written: manual
   reconciliation of every transaction, five replayed events producing no
   duplicates, P50 and P95 latency read from the logs, and a deliberate outage to
   prove the backlog drains on recovery. Fail it and we stop; you keep the
   assessment and the POC source.
3. **Production build** (4-8 weeks per system pair). Full edge cases (edits,
   voids, partial returns, merges, splits), deduplication, retries, dead-letter
   queue, scheduled reconciliation, alerting on queue depth, error rate, and
   latency, and a parallel run alongside the old process before anything is
   switched off.
4. **Managed operations** (monthly, ongoing). Monitoring, alerting, and incident
   response within committed hours, plus a scheduled reconciliation report.
   Handover is an option at any point and is written into the contract.

## What we do not do

We do not ask you to replace software that already works, and we do not quote a
production build before looking at your real data. Every pair of systems fails in
its own way, and most of that lives in what the API docs never mention. Discovery
and the POC exist so you do not have to take our word for it.

## Track record

Production integrations shipped with Base CRM, Lark Suite, and Odoo: some under
contract, some while running those systems from inside the business. Two
open-source n8n community nodes published and maintained on npm with outside
users. Integration infrastructure we have operated ourselves for months.

## Links

- [Blog](https://hecigo.com/blog/): mechanics, failure modes, and what we got wrong
- [Developer resources](https://hecigo.com/developers/): open-source n8n nodes, machine-readable endpoints
- [About](https://hecigo.com/about/): how the lab works and what it is accountable for
- [Contact](https://hecigo.com/contact/): email, phone, address, and the enquiry form
- [Privacy](https://hecigo.com/privacy/): what this site collects and why

## Contact

- Email: hi@hecigo.com
- Phone: (+84) 963 929 241
- Address: CirCO Dien Bien Phu, 222 Dien Bien Phu street, Vo Thi Sau ward, District 3, Ho Chi Minh City, Vietnam
- GitHub: https://github.com/hecigo
- LinkedIn: https://www.linkedin.com/company/hecigolab