Skip to content

Integration · Run stores and orders

TCC and Meteor AI agents

Track and quote TCC shipments over WhatsApp at your contract rate. The connector has 23 tools: 18 work in channels, while waybills are created only from admin.

Book a demo See every integration

How can you track and quote TCC shipments over WhatsApp?

With TCC and Meteor, your Met quotes at the real contract rate, tracks one waybill or many, explains statuses and exceptions, and checks coverage and cash on delivery. The connector exposes 23 tools: 18 query tools are available from WhatsApp and other channels. tcc_generar_guia records the dispatch and creates the waybill only from an authorized admin surface, in the configured environment, with human confirmation and an idempotencyKey required for auditability. Generating the printable label, requesting pickup and canceling the dispatch remain fail-closed until their production contracts are validated.

Where it applies: Colombia. The connector ships with the local master list of Colombian towns and their DANE code, to disambiguate identical names before quoting, and flags which ones are served by forwarding and which allow cash collection.

What it automates

What a Meteor Met does with TCC

Answer where my order is in seconds

The customer sends their waybill number and your Met answers with the tracking history, the status translated into plain language and the promised delivery date, with nobody opening the portal.

Quote the shipment before closing the sale

Your Met resolves the destination town code, quotes against your commercial agreement and answers the real shipping cost, with the billed weight the carrier applied.

Explain an exception instead of repeating it

When a shipment hits an exception, your Met says who it is attributable to and what comes next. Asking the customer for their address is not the same as apologizing and escalating internally.

Offer cash on delivery only where it exists

Before promising cash on delivery, your Met checks whether that town allows it. It is the promise most often broken when it is made from memory.

Tell on its way apart from never arriving

The connector carries the full TCC status catalog, including the two numbering systems the carrier mixes inside one response, and flags the five that mean the shipment will not arrive without somebody stepping in: compensation, customs hold, return, replaced waybill and cancellation. Partial delivery is kept apart from delivery too, which is the confusion that costs the most.

Warn about forwarding before promising a date

Some towns are served by forwarding: extra cost, extra days. The coverage check says so before you quote, along with whether the town code is still current, because a retired one will not ship even if the name still exists.

Create the waybill only from admin

A person reviews prevalidation and the quote in an authorized admin surface, loads the native TCC payload and confirms the operation. Only then does tcc_generar_guia record the dispatch in the configured environment. The idempotencyKey identifies the operation, but the connector does not deduplicate retries: the admin surface must prevent resubmitting the same dispatch. A WhatsApp message never executes this write.

23 tools

Everything your Met can ask TCC for

Each one is a real action in the connector. You can switch off the ones you would rather it never used.

Tool What it does
tcc_consultar_conexion Verifies that the access token is configured and reports the active environment and commercial account.
tcc_probar_conexion Diagnoses the token, environment, commercial agreement, origin city and operational readiness without recording a dispatch.
tcc_cotizar_envio A real shipment quote, with itemized charges, billed weight and promised transit days.
tcc_consultar_tarifas Returns the reference rate table for an origin and destination pair. It is not a quoting engine.
tcc_prevalidar_despacho Checks origin, coverage, address, weight, units, declared value and commercial agreement before creating a waybill. It does not write or quote.
tcc_rastrear_envio Tracks a waybill with its history, its exception and the delivery details.
tcc_consultar_remesa Queries one waybill through the safe endpoints available and returns status, origin, destination and units without exposing personal data.
tcc_diagnosticar_consulta_remesa Tests safe variants of the waybill query contract. This is an admin diagnostic and is not available in channels.
tcc_consultar_prueba_entrega Queries proof of delivery when TCC exposes it and returns trimmed data and links, never the base64 image.
tcc_rastrear_multiples Tracks several waybills in one call, instead of looping the same query.
tcc_consultar_envio The full shipment record: weights, freight, cash collection, promised date and parties.
tcc_generar_guia Records the dispatch in TCC and creates the waybill from an authorized admin surface. It uses the configured environment and requires human confirmation and an idempotencyKey.
tcc_generar_rotulo Protected contract for creating or retrieving the printable label. It fails closed until the production TCC endpoint is validated.
tcc_solicitar_recogida Protected contract for requesting waybill pickup. It fails closed until the production TCC endpoint is validated.
tcc_anular_despacho Protected contract for canceling a dispatch with an auditable reason. It fails closed until the production TCC endpoint is validated.
tcc_buscar_ciudad Finds a town in the local master list and returns its DANE code, disambiguating identical names.
tcc_consultar_cobertura Says whether TCC reaches a town, whether its code is still current, whether it is served by forwarding (which adds cost and days) and whether it allows cash on delivery.
tcc_validar_direccion Normalizes a Colombian address for dispatch, expanding street type abbreviations.
tcc_consultar_novedad Explains an exception and says whether it is attributable to the carrier, the customer or a third party.
tcc_informacion_remesas Lightweight tracking for many waybills at once, when all you need is the status.
tcc_consultar_estado Translates the 32 TCC status codes, which arrive in two different numbering systems, and flags the critical ones: compensation, customs hold, return, replaced waybill and cancellation.
tcc_normalizar_estado_envio Maps a TCC status code or text to an operating state such as in transit, delivered, exception, return, canceled or unknown.
tcc_ciudades_con_fce Lists the towns that allow freight on delivery with cash collection.

The limits

What the TCC integration does NOT do

We would rather say it here than have you find out during rollout.

Before you start

What you need to connect TCC

  1. 1

    A TCC API access token

    TCC provides it. The test token and the production token are different, and you declare the environment when configuring the integration.

  2. 2

    Your commercial agreement number

    It is your contract number with TCC. It is required to quote, because the rate depends on the agreement and not on a public list.

  3. 3

    Origin city and business unit (optional)

    Configured once with the code of the city you usually ship from and the service mode (parcel or courier), so you do not repeat them on every query.

  4. 4

    Credentials for the environment and a TCC payload, if you need to create a waybill

    Load them in the authorized admin surface together with the native grabardespacho8 payload. The operation also requires human confirmation and an idempotencyKey. Use the production environment for a real dispatch; the test environment can be used for testing.

Frequently asked questions

Questions about TCC and Meteor

Yes, but not from WhatsApp or any other channel. tcc_generar_guia records the dispatch only from an authorized admin surface in the configured environment, with human confirmation and an idempotencyKey. The key identifies the operation but does not deduplicate retries. The separate printable-label, pickup and cancellation commands remain blocked.

It is the real one. It is requested against your commercial agreement and returned with itemized charges and the billed weight the carrier applied. The rate table by origin and destination pair exists separately and is reference only.

With the local master list of towns and their DANE code. Colombia has three towns called Rionegro, and the connector forces you to disambiguate instead of choosing on its own.

Yes, in two ways: a batch lookup with the full detail, and a lightweight tracking call for when you only need the status of many waybills at a glance.

They are covered. The connector carries all 32 TCC status codes and turns them into language you can say out loud, without mixing partial delivery up with delivery. Five of them are flagged as critical because they mean the shipment will not arrive unless somebody steps in, and there your Met does not say "on its way".

Because TCC runs two numbering systems and mixes them inside one response, and it also returns codes that are in neither catalog. The connector resolves by one numbering first, then the other and, if neither lands, by the text. It never settles for the raw code.

Step by step

Automations that use TCC

Complete tasks, with the steps and the tools that run at each one.

Run stores and orders

Other integrations in the same family

Aveonline Andreani Chilexpress Éxito Fudo Homecenter

Want to see a Met running TCC?

We will show you with your own account connected, not with a canned demo.

Book a demo