ArgorantDocs

Etiquetas de buzones

Etiqueta los buzones nuevos al pedirlos, y etiqueta o firma cientos de buzones existentes en un solo paso, por ejemplo todos los buzones de un pedido.

Las etiquetas son nombres cortos en tus buzones, como Q4 push o Germany. Con ellas filtras en la página Buzones, eliges los remitentes de una campaña y cambias muchos buzones a la vez. Un buzón admite hasta 30 etiquetas. Las etiquetas solo sirven para marcar buzones: nunca envían nada ni cambian ninguna configuración.

Al pedir buzones

En el pedido, el paso de revisión tiene Etiquetas de buzones. Elige etiquetas que ya usas o escribe nuevas, hasta 10. Todos los buzones de ese pedido las reciben, también los que se configuran más tarde, así que nunca etiquetas un pedido nuevo a mano.

La página del pedido muestra las etiquetas en Etiquetas de buzones. Cámbialas ahí y todos los buzones del pedido cambian a la vez. Los buzones que el pedido todavía está configurando también reciben las etiquetas nuevas.

Muchos buzones existentes a la vez

  1. Abre Buzones y filtra la lista: por pedido, dominio, etiqueta, estado o campaña.
  2. Marca la casilla del encabezado de la tabla y luego haz clic en Seleccionar todo en la barra de selección para tomar todos los buzones que coinciden, no solo la página que ves.
  3. En la barra de selección, haz clic en Editar para agregar o quitar etiquetas, o en Firma para darles a todos una misma firma.

Para etiquetar todos los buzones de un pedido anterior, elige ese pedido en el filtro de pedidos (Todos los pedidos), o abre el pedido y haz clic en Mostrar los buzones de este pedido.

Una firma para muchos buzones sigue siendo personal: escribe {{sender_first_name}} y {{sender_last_name}}, y cada buzón firma con su propio nombre. Consulta Firmas.

Con la API

Etiqueta todos los buzones de un pedido. La primera llamada solo cuenta; envíala de nuevo con "preview": false para cambiarlos:

Shell
curl -X POST "https://app.argorant.com/api/v1/inboxes/tags" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"order_id":"b345aa96-059d-47e7-b733-c1899f843a00","add":["Q4 push"],"preview":false}'

Elige los buzones con emails, domains, tags (buzones que tienen todas ellas), status u order_id, y quita etiquetas con remove. GET /api/v1/inboxes/tags lista todas las etiquetas con cuántos buzones tiene cada una.

Asigna las etiquetas a un pedido al hacerlo (tags en POST /api/v1/inboxes/orders), o cámbialas después para los buzones del pedido, los actuales y los que vendrán:

Shell
curl -X POST "https://app.argorant.com/api/v1/inboxes/orders/b345aa96-059d-47e7-b733-c1899f843a00/tags" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"add":["Q4 push"],"remove":["Test"]}'

Una sola firma para todos los buzones de un pedido: POST /api/v1/inboxes/signature/bulk con order_id (o tags) y la plantilla.

Con la CLI y asistentes de IA

Shell
argorant inboxes tags
argorant inboxes tag --order <order-id> --add "Q4 push"
argorant inboxes tag --domains acme.com --add Germany --remove Test
argorant inboxes order-tags <order-id> --add "Q4 push"
argorant inboxes signature bulk --order <order-id> --text "Best,\n{{sender_first_name}}"

En Claude y ChatGPT, las herramientas son argorant_list_inbox_tags y argorant_tag_inboxes. En Claude, argorant_set_order_tags cambia las etiquetas de un pedido, y argorant_order_inboxes acepta tags.

En esta página