Atualizar contato no Constant Contact, por uma API

Atualiza um contato substituindo seus campos principais: email_address, nomes, job_title, company_name, birthday e anniversary omitidos ficam vazios, então envie também os valores atuais, obtidos em Listar contatos. Subrecursos omitidos são mantidos, e o que é enviado substitui o atual.

Identificador
constant_contact_update_contact

A chamada

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

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "contact_id": "<contact_id>",
    "update_source": "Account"
  }
}

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
contact_idstringSimId of the contact, from List contacts.
update_sourcestringSimWho makes the change: Account when the account user changes it, Contact when the person asked for it. A deleted contact comes back only with Account.Valores: Account, Contact
email_addressobjectNãoEmail address of the contact. permission_to_send explicit or implicit is allowed only when the person agreed to receive emails; unsubscribed opts the contact out, with an optional opt_out_reason.
first_namestringNãoFirst name of the contact.
last_namestringNãoLast name of the contact.
job_titlestringNãoJob title of the contact.
company_namestringNãoCompany where the contact works.
birthday_monthintegerNãoMonth of the birthday, 1 to 12. Send it together with birthday_day.
birthday_dayintegerNãoDay of the birthday, 1 to 31. Send it together with birthday_month.
anniversarystringNãoAnniversary date, such as when the contact became a customer, as YYYY-MM-DD or MM/DD/YYYY.
phone_numbersarrayNãoUp to 3 phone numbers. When sent, they replace the current ones.
street_addressesarrayNãoUp to 3 street addresses, each with its kind. When sent, they replace the current ones.
list_membershipsarrayNãoIds of all the lists the contact should be in, from List contact lists, up to 50. When sent, the contact leaves the lists that are not in it. The current lists come from List contacts with include list_memberships.

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_contact. 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.