Saltar al contenido
firmo
Docs / WhatsApp

WhatsApp

Facturar por WhatsApp con el número de Firmo o el tuyo (Twilio): números autorizados, varias empresas, administración de la plataforma y comandos.

Con el canal de WhatsApp, un usuario del portal factura escribiendo como hablaría con una persona: «Hazme una factura a Ferretería El Puente, RNC 131000000. Le vendí 10 sacos de cemento a 500 c/u». No hay una sintaxis que aprender: Firmo interpreta el mensaje con Claude. Le responde con un resumen, espera su confirmación («dale», «sí, mándala»), emite el e-CF y le devuelve el e-NCF, el estado en la DGII y el PDF. Funciona sobre la API de WhatsApp de Twilio. Cada empresa elige entre dos modos y, en ambos, solo atiende a los números que la empresa autorizó.

Empieza en tres pasos#

  1. Autoriza tu número en el portal, en WhatsApp → 2. Números autorizados.
  2. Escríbele «hola» al WhatsApp de Firmo, +1 849-567-2911. Tu número queda activo y recibes la bienvenida.
  3. Factura: dile qué vendiste, revisa el resumen y confirma con «dale».

Dos modos: WhatsApp de Firmo o número propio#

ModoQué esQué configuras
WhatsApp de FirmoUn número de WhatsApp de la plataforma, el mismo para todas las empresas. Es el modo por defecto y el recomendado.Nada: solo autorizas los números de tu equipo.
Mi propio númeroTu cuenta de Twilio y tu número. Los mensajes entran por un webhook propio de tu empresa y Twilio te los cobra a ti.La cuenta de Twilio (Account SID, Auth Token, número) y el webhook en el sender.

El modo se cambia en WhatsApp → 1. Cómo quieres usar WhatsApp (dueño o admin) o con PUT /v1/channels/whatsapp/mode. La lista de números autorizados se conserva al cambiar de modo. Una empresa que ya tenía su propio Twilio antes de existir el WhatsApp de Firmo sigue en «propio».

Números autorizados#

Los pueden administrar el dueño y los administradores en WhatsApp → 2. Números autorizados. Cada número se asigna a un usuario de la cuenta: el rol y los permisos salen de ese usuario (uno de lectura puede consultar pero no emitir ni reenviar), con una etiqueta opcional («Caja», «Contador»). Un teléfono es único por empresa, un usuario puede tener varios números y hay hasta 25 por empresa.

  1. Pendiente. Al agregar el número no se le escribe nada: WhatsApp solo deja que un negocio escriba primero con plantillas aprobadas, que cuestan. Por eso el número queda pendiente.
  2. Activo. El primer mensaje que llegue de ese teléfono lo activa y Firmo responde con una bienvenida con ejemplos («Hola Ana, ya puedes facturar para Ferretería El Puente…»). Si ese primer mensaje ya traía una factura o una consulta, también se atiende.
  3. Desactivado. El administrador lo desactiva (o lo quita) cuando quiera. Los teléfonos que no estén en la lista, o estén desactivados, reciben una sola vez por hora: «Este número no está autorizado para facturar con Firmo. Pídele al administrador de tu empresa que lo agregue en Firmo → WhatsApp.»
bash
# Autorizar un número (queda «pendiente»: no se le escribe nada)
curl -X POST https://api.firmo.do/v1/channels/whatsapp/numbers \
  -H "Authorization: Bearer $FIRMO_SESION" \
  -H "Content-Type: application/json" \
  -d '{ "telefono": "809-555-1234", "usuarioId": "00000000-0000-4000-8000-000000000000", "etiqueta": "Caja" }'

# Desactivar (o reactivar) y quitar
curl -X PATCH  https://api.firmo.do/v1/channels/whatsapp/numbers/$ID -H "Authorization: Bearer $FIRMO_SESION" \
  -H "Content-Type: application/json" -d '{ "activo": false }'
curl -X DELETE https://api.firmo.do/v1/channels/whatsapp/numbers/$ID -H "Authorization: Bearer $FIRMO_SESION"
RutaQué hace
GET /v1/channels/whatsapp/numbersLa lista (teléfono, etiqueta, usuario, estado, último uso) y los usuarios asignables.
POST /v1/channels/whatsapp/numbers{ telefono, usuarioId, etiqueta? } → 201. Los de 10 dígitos se toman como +1. 409 si ya está en la lista.
PATCH /v1/channels/whatsapp/numbers/{id}{ activo?, etiqueta?, usuarioId? }.
DELETE /v1/channels/whatsapp/numbers/{id}Quita el número de la lista.
PUT /v1/channels/whatsapp/mode{ modo: "firmo" | "propio" }.
GET /v1/channels/whatsappEstado del canal (modo, número al que escribir, conteo de números). Cualquier sesión del portal.
Respuesta de GET /v1/channels/whatsapp (EstadoWhatsapp)
{
  "modo": "firmo",
  "habilitado": true,
  "motivo": null,
  "plataformaDisponible": true,
  "configuracion": "sin_configurar",
  "numeroWhatsapp": "+18095551234",
  "enlaceWhatsapp": "https://wa.me/18095551234",
  "interprete": "claude",
  "numeros": { "total": 3, "activos": 2, "pendientes": 1 },
  "ambiente": "sandbox"
}

Cambio de contrato

El antiguo vínculo con código de 6 dígitos (POST /v1/channels/whatsapp/link, /verify y DELETE /v1/channels/whatsapp) se retiró: necesitaba que Firmo escribiera primero. Los números que ya estaban verificados pasaron a ser números autorizados y activos.

Cómo funciona#

Conversación
Tú:    Hola! Hazme una factura a Ferretería El Puente, RNC 131000000. Le vendí 10 sacos de cemento a 500 c/u
Firmo: *Factura de crédito fiscal (E31)*
       Cliente: Ferretería El Puente · RNC 131000000
       • 10 × Cemento a RD$500 = RD$5,000
       Subtotal: RD$5,000
       ITBIS: RD$900
       *Total: RD$5,900*
       Modo prueba: no llega a la DGII.
       ¿La emito? Dime *sí* o *no*.
Tú:    Dale
Firmo: *Factura de crédito fiscal (E31) E310000000001*
       Estado: Aceptado por el simulador (modo prueba)
       Total: RD$5,900
       Te adjunto el PDF (el enlace vence en 7 días).   [PDF]
  1. Twilio recibe el mensaje y hace POST al webhook (/v1/channels/whatsapp/twilio/{webhookId}) con el formulario del mensaje. El webhookId es aleatorio (24 caracteres) y es de una empresa («propio») o de la plataforma («WhatsApp de Firmo»).
  2. Firmo valida la firma X-Twilio-Signature con el Auth Token de esa empresa o de la plataforma, responde 200 al instante y encola el mensaje (Twilio corta a los 15 s).
  3. El worker busca el número From entre los autorizados: en el webhook de una empresa, en esa empresa; en el de la plataforma, en todas las empresas en modo «firmo». Sin coincidencia, responde el aviso de «no autorizado». Con una, atiende a esa empresa con el usuario del número. Con varias, ver abajo.
  4. Interpreta el texto y guarda la propuesta 15 minutos. Cuando el usuario confirma («dale», «sí», «ok, perfecto»; un «no» o «mejor no» la descarta), emite con el id de la conversación como llave de idempotencia: un reintento nunca factura dos veces.
  5. Responde por la API REST de Twilio con las credenciales del modo de la empresa y el resultado, con el PDF en MediaUrl: un enlace firmado que vence en 7 días.

Si la empresa está en producción, el resumen avisa que la factura es real y la confirmación tiene que ser explícita, por ejemplo «sí, emítela». Con «modo prueba» el usuario practica en sandbox aunque su empresa ya esté en producción.

Un teléfono en varias empresas (WhatsApp de Firmo)

Un contador puede estar autorizado en varias empresas con el mismo teléfono. La primera vez, Firmo pregunta «¿Para cuál empresa quieres facturar? 1) … 2) …» y recuerda la respuesta por teléfono. Para cambiar, el usuario escribe «cambiar empresa» (muestra la lista) o «cambia a Ferretería El Puente». Esos mensajes se reconocen con reglas fijas, antes del intérprete de Claude, para que nunca se tomen por una factura. Si el teléfono queda autorizado en una sola empresa, deja de preguntar.

Notas de voz#

Puedes mandarle a Firmo una nota de voz en lugar de escribir (hasta 2 minutos y 5 MB). Firmo la transcribe y te responde primero «Entendí: "…"»; después sigue igual que si lo hubieras escrito: facturas, reportes, «dale» para confirmar, «no» para cancelar. Si no entiende el audio te pide que lo repitas o lo escribas.

Cómo te responde lo eliges por número, en el portal (lista de números autorizados, selector «Respuestas») o escribiéndole:

PreferenciaQué haceCómo pedirla por WhatsApp
Automático (por defecto)Responde con nota de voz si tú mandaste una nota de voz; por texto si escribiste.«como yo te escriba», «automático»
Siempre por textoNunca manda audios (igual entiende tus notas de voz).«respóndeme en texto», «escríbeme», «no me mandes audios»
Siempre con vozResponde siempre con nota de voz.«respóndeme en voz», «mándame audios», «háblame»

La nota de voz es una versión corta y hablada (cliente, total y «¿La emito?»; «tu factura quedó aceptada»…). Los datos importantes siempre llegan también por escrito: el resumen con los montos, el e-NCF y el enlace al PDF. Si la voz no está disponible, solo recibes el texto. Con tu propio número de Twilio las notas de voz funcionan igual.

La transcripción y la voz usan ElevenLabs (Scribe y texto a voz) y la llave la configura la plataforma (ELEVENLABS_API_KEY). Cada nota de voz cuenta como un mensaje más del plan; el límite de facturas por WhatsApp no cambia. El audio que Firmo te manda se sirve por un enlace firmado que vence en 1 hora (/v1/public/whatsapp/audio/{id}).

Enviar un Excel por WhatsApp#

Para facturar muchas ventas de una vez, mándale a Firmo tu archivo .xlsx (la plantilla de Firmo, hojas Facturas y Detalle, o el formato de una factura por hoja) o un .csv como adjunto. Firmo lo valida con las mismas reglas del portal (Importar) y te responde con un resumen: «Recibí tu archivo: 12 facturas por RD$84,300.00 en total (9 E31, 3 E32). ¿Las emito?», con las primeras 5 facturas (referencia, cliente y total) y «y 7 más».

  • Los precios del archivo se leen como en el portal: sin ITBIS en precio_unitario o con el ITBIS incluido en precio_con_itbis (en el formato de factura, la celda «Precios incluyen ITBIS»). La preferencia «Los precios incluyen ITBIS» de la empresa solo cambia las facturas que escribes en el chat, no el Excel.
  • Si el archivo tiene errores, no emite nada: te lista hasta 10 con hoja, fila, columna y mensaje, y te pide corregirlo y enviarlo de nuevo.
  • La confirmación siempre es explícita. En pruebas basta «sí» o «dale»; en producción debes escribir «sí, emítelas» (también vale «dale, emítelas»). La aprobación automática no aplica a los archivos. La propuesta vence a los 15 minutos y un mensaje de factura o un archivo nuevo la reemplaza; «no» la descarta.
  • Al confirmar responde «Emitiendo N facturas…», las emite por la cola igual que el portal y, cuando el lote termina, te manda el resultado. Con una sola factura: el e-NCF, el estado y el PDF como siempre. Con varias: la lista «E31… aceptada · RD$…» (hasta 20 líneas, primero las rechazadas o con error y su motivo), el resumen de conteos y dos enlaces firmados que vencen en 7 días: un ZIP con los PDF (hasta 500) y el Excel de resultados.
  • Límites: 5 MB y 2,000 facturas por archivo. Un .xls viejo no se lee: guárdalo como .xlsx. Un usuario de solo lectura no puede enviar archivos para emitir.
  • Plan: los e-CF del archivo salen con canal whatsapp pero no cuentan en el límite de facturas por WhatsApp del plan; sí cuentan en el límite mensual de e-CF reales. En el plan Gratis, si el archivo trae más facturas de las que te quedan del mes, no se emite ninguna y se te ofrece mejorar el plan; los planes de pago no se frenan (se avisa al 80 y 100 %).

Los enlaces son GET /v1/public/imports/{id}/zip y /results con ?exp=…&sig=… (HMAC-SHA256 del archivo, la importación y exp): un enlace vencido responde 410 y uno alterado 403. Si envías varias facturas a la vez y hay muchas, también puedes bajar los resultados desde el portal.

Enviar la factura por correo#

El usuario puede pedirla por texto o por nota de voz: «envíasela por correo», «mándale la factura por email», «envía la E320000000005 a juan@empresa.com», o dentro de la factura («… y mándasela por correo», se envía cuando queda emitida). Firmo manda la representación impresa con el PDF y el XML firmado por correo (Resend) y decide el destino así: (1) la dirección escrita en el mensaje (siempre debe aparecer literal; Firmo nunca la inventa); (2) si no hay, el correo guardado del cliente (se busca por RNC y, si no, por nombre exacto); (3) si tampoco hay, manda el PDF por el chat y responde «No tengo correo registrado para … Si me dices el correo se la envío»; entonces basta con contestar solo la dirección. Cuando el correo lo dio el usuario y es distinto del guardado, pregunta «¿Quieres que guarde … como correo de …?» (o «¿Lo guardo como cliente nuevo?»); un «sí» actualiza o crea el cliente. Si hay una factura esperando su «sí», esa confirmación tiene prioridad y no se hace esa pregunta. En notas de voz, «juan arroba gmail punto com» se convierte en juan@gmail.com y el eco «Entendí: …» lo muestra. Solo los usuarios que pueden emitir envían correos y modifican clientes (uno de solo lectura recibe el PDF); la factura debe ser de la empresa y del modo actual. Cada envío queda en el historial del e-CF (acción correo, origen whatsapp). Si el servidor no tiene RESEND_API_KEY, Firmo responde «Por ahora no puedo enviar correos desde Firmo; te mando el PDF aquí» y manda el PDF.

Auto aprobar#

Si confías en lo que Firmo entiende, puedes pedirle que emita sola la factura propuesta cuando no le respondes. Escribe «aprueba automáticamente si no respondo en 30 segundos» (de 5 a 300 segundos; sin número, 10). Desde entonces el resumen termina con «La emito en 30 segundos si no me dices nada. Escribe *no* para cancelar.» (también en la nota de voz). Mientras corre el reloj, «no» la cancela, «dale» la emite al instante y una factura nueva reemplaza a la anterior. Para apagarlo: «espera que yo confirme» o «ya no apruebes automáticamente». También es un interruptor por número en el portal, con los segundos. Respeta el rol (un usuario de solo lectura no puede), el límite del plan y la vigencia de la propuesta.

En producción las facturas son reales y van a la DGII. Por eso, al activarlo con la empresa en producción, Firmo pregunta «Ojo: con esto las facturas REALES se envían a la DGII sin que confirmes. ¿Lo activo?» y solo lo activa con «sí, actívalo»(en el portal, con un diálogo de confirmación). Si lo activaste en pruebas y la empresa luego pasa a producción, queda en pausa hasta que lo confirmes de nuevo (Firmo te lo avisa una vez).

Límites por plan#

Con el WhatsApp de Firmo, cada plan incluye un número de facturas por WhatsApp al mes por empresa: Emprende 50, Negocio 300, los planes a medida sin tope (el sandbox, 10). El plan Gratis incluye 5. En el portal, en WhatsApp, ves el uso del mes («Este mes: 34 de 300 facturas por WhatsApp»). Al llegar al 80% Firmo te avisa una vez; al llegar al límite deja de emitir por WhatsApp hasta el mes siguiente, pero las consultas, los reportes y los reenvíos siguen funcionando, y puedes seguir facturando desde el portal o la API. Con tu propio número de Twilio no hay límite de Firmo.

Avisos por WhatsApp#

Firmo le avisa por WhatsApp al dueño y a los administradores de la empresa (solo a sus números autorizados) cuando algo necesita atención:

  • Tu certificado digital vence en 30, 15, 7 o 1 día.
  • Una factura fue rechazada o tuvo un error en producción (como mucho un mensaje por hora, con el resumen).
  • Hay facturas sin respuesta de la DGII por más de 24 horas (una vez al día).
  • Te queda el 10% o menos de una secuencia de e-NCF, o vence en 15 días o menos (una vez al día).

Escribe «no más avisos» para dejar de recibirlos y «activar avisos» para volver a recibirlos. También puedes activarlos o desactivarlos por número en el portal, en la lista de números autorizados.

El WhatsApp de Firmo (administración de la plataforma)#

El administrador de la plataforma lo gestiona en Admin → WhatsApp (/v1/admin/whatsapp, solo correos de PLATAFORMA_ADMINS): estado, número, Account SID enmascarado, el Auth Token de solo escritura (cifrado con la misma llave maestra; solo se ve «••••••••» y sus 4 últimos caracteres), la URL del webhook para pegar en el sender de Twilio, el botón Probar (consulta la cuenta en Twilio, no envía mensajes), activar o desactivar (desactivado: el webhook responde 410) y el uso del mes por empresa.

Ruta de administraciónQué hace
GET /v1/admin/whatsappEstado enmascarado, URL del webhook, empresas con Twilio propio (candidatas) y uso del mes (?month=YYYY-MM).
PUT /v1/admin/whatsapp/config{ accountSid, authToken?, numeroWhatsapp }. Sin authToken conserva el actual.
POST /v1/admin/whatsapp/testValida las credenciales contra Twilio y guarda conectado o error.
POST /v1/admin/whatsapp/activate{ activo }.
POST /v1/admin/whatsapp/promote{ empresaId, cambiarEmpresa } copia en el servidor la configuración (cifrada) de una empresa a la de la plataforma, con su mismo webhook.

Promover la configuración de una empresa copia los valores cifrados sin descifrarlos ni devolverlos y conserva su webhookId: si el sender de Twilio ya apuntaba a esa URL, no hay que cambiar nada allá. La empresa conserva su copia con un webhook nuevo y, con cambiarEmpresa, pasa al modo «firmo». Toda escritura queda en la auditoría, sin secretos.

Uso: por empresa y mes se cuentan los mensajes recibidos, los enviados (y cuántos con PDF) y las facturas emitidas por WhatsApp. Hoy solo se mide.

Pendiente: límites por plan

TODO: aplicar límites de mensajes por plan (hoy no hay ninguno; solo se miden en whatsapp_uso). Los mensajes de bienvenida y las respuestas dentro de la ventana de 24 horas no necesitan plantilla; solo contarían las conversaciones que Firmo inicie.

Modo «propio»: conectar la cuenta de Twilio de la empresa#

Lo hace el dueño o un administrador en el portal: Account SID, Auth Token y número de WhatsApp. El botón Guardar y probar conexión guarda y consulta la cuenta en Twilio. El Auth Token se guarda cifrado (AES-256-GCM) y nunca se vuelve a mostrar: la API solo devuelve sus últimos 4 caracteres. El webhook de una empresa que pasa a «firmo» responde 410.

1. Pruebas con el sandbox de Twilio (solo para quien usa su propio número)

El WhatsApp de Firmo (+1 849-567-2911) ya está en producción y no necesita sandbox. Esta sección es solo para probar gratis con tu propia cuenta de Twilio.

  1. Crea una cuenta en Twilio. Copia el Account SID y el Auth Token de Account Info y pégalos en el portal.
  2. En Twilio, abre Messaging → Try it out → Send a WhatsApp message. El sandbox usa el número +1 415 523 8886.
  3. Desde tu teléfono, envía a ese número el mensaje join <palabra> que te muestra Twilio. Cada teléfono que vaya a probar debe hacerlo (y repetirlo a los 3 días sin uso). Guarda ese código (por ejemplo yellow-banana, sin el join) en el campo Código del sandbox del portal: Firmo lo muestra a tu equipo con un enlace que abre WhatsApp con el mensaje listo. En el WhatsApp de Firmo, el administrador de la plataforma lo guarda en /admin/whatsapp.
  4. En Sandbox settings, en When a message comes in, pega la URL del webhook que muestra el portal, con el método POST:
texto
https://api.firmo.do/v1/channels/whatsapp/twilio/{webhookId}

En el portal, usa whatsapp:+14155238886 como número de WhatsApp y pulsa Guardar y probar conexión. Con la conexión en verde, autoriza los números del equipo.

La URL debe coincidir

Twilio firma la URL exacta que configuraste y Firmo la valida con API_URL_PUBLICA + la ruta con el webhookId. Si la pegas mal o generas una nueva en el portal (Generar nueva URL), el webhook responde 404 o 403 hasta que la actualices en Twilio.

2. Producción: sender de WhatsApp aprobado

  1. En Twilio, registra un WhatsApp Sender con tu número y tu cuenta de WhatsApp Business (Meta verifica la empresa; tarda de horas a días).
  2. Pega la misma URL del webhook en el sender, con el método POST.
  3. En el portal, cambia el número de WhatsApp por el de tu sender (whatsapp:+1809…) y vuelve a probar la conexión.

3. Plantillas de mensajes

WhatsApp solo deja escribir texto libre dentro de las 24 horas siguientes al último mensaje del usuario. Fuera de esa ventana, el primer mensaje debe ser una plantilla aprobada por Meta (Twilio Content Template Builder). Firmo ya no inicia conversaciones (la activación de números se hace con el primer mensaje del usuario), así que no necesitas crear plantillas para facturar; el aviso «te avisamos cuando la DGII responda» sale dentro de la ventana de 24 horas.

Rutas de configuración (modo «propio»)

Solo con la sesión del portal y rol dueño o admin. Actúan sobre la empresa activa.

RutaQué hace
GET /v1/channels/whatsapp/configLa configuración sin el token, con la URL del webhook y las instrucciones.
PUT /v1/channels/whatsapp/configCrea o actualiza. Sin authToken conserva el anterior. El SID debe ser AC + 32 hexadecimales.
POST /v1/channels/whatsapp/config/testPrueba la conexión y guarda el estado (conectado o error, con el motivo en español).
POST /v1/channels/whatsapp/config/rotate-webhookGenera una URL nueva; la anterior responde 404.
DELETE /v1/channels/whatsapp/configDesconecta: el webhook responde 410. Los números autorizados se conservan.
bash
# Modo «propio»: guardar la cuenta de Twilio de la empresa (sesión del portal, rol dueño o admin)
curl -X PUT https://api.firmo.do/v1/channels/whatsapp/mode \
  -H "Authorization: Bearer $FIRMO_SESION" \
  -H "Content-Type: application/json" \
  -d '{ "modo": "propio" }'

curl -X PUT https://api.firmo.do/v1/channels/whatsapp/config \
  -H "Authorization: Bearer $FIRMO_SESION" \
  -H "Content-Type: application/json" \
  -d '{
    "accountSid": "AC0123456789abcdef0123456789abcdef",
    "authToken": "tu-auth-token",
    "numeroWhatsapp": "+14155238886"
  }'

# Probar la conexión (GET /2010-04-01/Accounts/{SID}.json en Twilio; no envía mensajes)
curl -X POST https://api.firmo.do/v1/channels/whatsapp/config/test \
  -H "Authorization: Bearer $FIRMO_SESION"
Respuesta (ConfigWhatsapp)
{
  "configurado": true,
  "activo": true,
  "estado": "conectado",
  "ultimoError": null,
  "verificadoEn": "2026-10-07T14:20:00.000Z",
  "accountSid": "AC0123456789abcdef0123456789abcdef",
  "authTokenFinal": "9f3a",
  "numeroWhatsapp": "+14155238886",
  "plantillaCodigoSid": null,
  "webhookUrl": "https://api.firmo.do/v1/channels/whatsapp/twilio/Xb3kZ9qL0pR2sT4uV6wY8a1c",
  "numeroSandbox": "+14155238886",
  "instrucciones": { "sandbox": ["…"], "produccion": ["…"] }
}

Cómo se interpreta el mensaje#

  • Con ANTHROPIC_API_KEY (de la plataforma Firmo, no de cada empresa): Claude Haiku 4.5 recibe el mensaje, las reglas (E31 con RNC, E32 por defecto, precios sin ITBIS salvo «con ITBIS incluido» o que la empresa tenga «Los precios incluyen ITBIS», en cuyo caso «más ITBIS» lo anula; ITBIS 18%) y hasta 50 productos y 50 clientes guardados, y responde con la herramienta crear_factura. Firmo valida la salida y descarta cualquier RNC que no esté en el mensaje ni en tus clientes: nunca inventa un RNC.
  • Sin la llave: formato fijo, factura 31 rnc 131000000; 10 x cemento @ 500; 2 x arena @ 300 (con exento después del precio y itbis incluido en la primera parte cuando aplique).

Comandos#

MensajeRespuesta
ayudaEjemplos y comandos.
ultimasLas últimas 5 facturas.
estado E310000000001Estado del e-CF en la DGII.
pdf E310000000001El PDF adjunto.
envíasela por correoEnvía la última factura (o la E32… que digas, a la dirección que escribas) por correo.
(adjuntar un .xlsx o .csv)Valida el archivo y propone emitir todas las facturas; confirmas con «sí» (producción: «sí, emítelas»).
cancelarDescarta la factura o el archivo pendiente.
modoSi estás en prueba o en producción (y modo prueba / modo producción para cambiar).

PDF con enlace firmado#

GET/v1/public/ecf/{id}/pdf?exp=…&sig=…

La representación impresa en PDF, sin API key, para que Twilio la descargue y la adjunte. exp es el vencimiento (7 días) y sig un HMAC-SHA256 del id y exp. Un enlace vencido responde 410 y uno alterado 403.

Costos

Twilio cobra cada mensaje de WhatsApp más la tarifa de Meta por conversación, directamente a la cuenta de Twilio de cada empresa. La interpretación con Claude Haiku 4.5 la pone Firmo (alrededor de medio centavo de dólar por mensaje).