Atualizar atividade da campanha de e-mail no Constant Contact, por uma API

Atualiza a atividade primary_email de uma campanha em status DRAFT ou DONE. Ela substitui as propriedades: envie o remetente, assunto, preheader e listas atuais, de Obter atividade da campanha de e-mail, junto com as mudanças, pois o que ficar de fora é apagado. html_content e physical_address_in_footer são mantidos quando não enviados.

Identificador
constant_contact_update_email_campaign_activity

A chamada

POST https://connect.reportei.com/api/tools/constant_contact_update_email_campaign_activity/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "campaign_activity_id": "<campaign_activity_id>",
    "from_name": "<from_name>",
    "from_email": "<from_email>",
    "reply_to_email": "<reply_to_email>",
    "subject": "<subject>"
  }
}

Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.

Parâmetros

As descrições dos parâmetros seguem a documentação oficial do app, em inglês.

ParâmetroTipoObrigatórioDescrição
campaign_activity_idstringSimId of the activity with role primary_email, from Get email campaign or Create email campaign.
contact_list_idsarrayNãoIds of the lists that receive the email, from List contact lists. Required before scheduling, unless the activity uses a segment.
segment_idsarrayNãoThe segment that receives the email, as returned by Get email campaign activity. Send it back to keep it. Never together with contact_list_ids.
from_namestringSimSender name shown to contacts.
from_emailstringSimSender address, a confirmed email address of the account.
reply_to_emailstringSimAddress that receives the replies, a confirmed email address of the account.
subjectstringSimSubject of the email.
preheaderstringNãoShort summary shown after the subject in the inbox.
html_contentstringNãoNew HTML body, only for format_type 5. Keep [[trackingImage]] inside the body element so opens and clicks are reported.
physical_address_in_footerobjectNãoAddress of the sender shown in the footer. state_code is required when country_code is US.

Conexões possíveis

O seu cliente conecta a conta do Constant Contact uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.

OAuth com o app do seu produto

Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/constant_contact, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.

A resposta

Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.

Pronta para agentes de IA

O input desta tool é um JSON Schema, disponível em GET /api/tools/constant_contact_update_email_campaign_activity. Ele vira a definição de tool do seu agente sem conversão.

Outras tools do Constant Contact

Ver as 12 tools

Toolkits da mesma categoria

Ver os 100 toolkits

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.