Ir a la documentación
Servidor MCP

Envíos a audiencias

Un correo para todos los de una o más audiencias, con una copia aparte para cada persona.

Herramientas de envíos a audiencias

HerramientaQué hace
previewAudienceSendA cuántas personas llegaría un envío a estas audiencias, antes de enviar nada, con cuántas se omitirían por haberse dado de baja y cuántas porque su dirección está suprimida. Una persona en varias de las audiencias cuenta una vez.
sendToAudienceEnvía un correo desde una de tus direcciones a todos los de hasta 10 audiencias, cada persona con su propia copia. Acepta html o text con campos de combinación como {{firstName|there}}, o una plantilla, y una hora de envío opcional. Responde al momento y el envío sigue en segundo plano.
listBroadcastsLos envíos a audiencias desde este buzón, el más nuevo primero, con lo lejos que llegó cada uno, página a página. Indica una audiencia para ver solo los envíos que la incluían.
getBroadcastUn envío y lo lejos que llegó: para cuántas personas era, cuántas copias esperan, se enviaron, fallaron o se cancelaron, y cuántas personas se omitieron.
cancelBroadcastDetiene un envío. Cada copia que aún no ha salido se cancela y no se añade a nadie más. Las copias ya enviadas no se pueden recuperar.

Cada copia es un correo normal dirigido a una sola persona, así que nadie ve a quién más se envió, y cada una tiene su propio seguimiento y sus webhooks. Las copias no se archivan en Enviados: el envío es el registro, y getBroadcast es la forma de seguirlo.

Los campos de combinación son {{firstName}}, {{lastName}}, {{name}}, {{email}} y {{unsubscribeUrl}}, cada uno con un valor de reserva opcional tras una barra. Cada copia lleva una cabecera de baja con un clic, y un cuerpo que no coloca {{unsubscribeUrl}} por sí mismo recibe una breve línea de baja al final. Quien se da de baja queda marcado como dado de baja en todas las audiencias a las que fue ese envío, y los envíos posteriores a esas audiencias lo omiten, igual que omiten las direcciones de la lista de supresión.

Todo el envío se compara con el plan antes de que salga nada, así que un envío que el plan no puede cubrir se rechaza en lugar de pararse a medias. Nada hace seguro repetir sendToAudience, así que tras una respuesta perdida consulta listBroadcasts antes de volver a intentarlo.

sendToAudience necesita emails:send y audiences:read, previewAudienceSend necesita audiences:read, listBroadcasts y getBroadcast necesitan emails:read, y cancelBroadcast necesita emails:send. El asistente de la app siempre pregunta antes de sendToAudience, y pregunta antes de cancelBroadcast salvo que tú lo hayas pedido. Quien solo tiene acceso a algunas direcciones envía solo a los contactos que añadió.