Como Gerenciar as Automações

Sobre a função

Esse grupo de integrações oferece a funcionalidade de inserir e remover contatos de uma "régua" de relacionamento. Com essas integrações, é possível gerenciar de forma eficiente o envolvimento dos contatos ao longo da régua, garantindo uma comunicação personalizada e bem-sucedida com os clientes em diferentes etapas do relacionamento.

30.05 - Inserindo Contatos em uma Automação

Utilize esta integração para inserir contatos diretamente em uma régua de relacionamento (automação).

Primeiros Passos para implementar:

1.Crie o fluxo na plataforma Akna.
2.Obtenha o campo [hash]. Preencha esse campo com um "hash" encontrado na plataforma.
3.Caminho para obter o “hash”: Em automações cadastradas. Edite a automação que deseja fazer a integração. No campo importar listas escolha a opção “Importar via API”.

4 - Copie a hash do campo "automação".

Utilize a hash copiada da plataforma no XML de envio como segue abaixo.

XML de envio estrutura completa

<main>
  <emkt trans="30.05">
    <automacao>[HASH]</automacao>
    <destinatario>
      <nome>[NOME]</nome>
      <email>[EMAIL]</email>
      <sexo>[SEXO]</sexo>
      <idade>[IDADE]</idade>
      <data_nascimento>[DATA_NASCIMENTO]</data_nascimento>
      <empresa>[EMPRESA]</empresa>
      <cpf>[CPF]</cpf>
      <atividade>[ATIVIDADE]</atividade>
      <profissao>[PROFISSAO]</profissao>
      <tipoend>[TIPO DE ENDERECO]</tipoend>
      <endereco>[ENDERECO]</endereco>
      <complemento>[COMPLEMENTO]</complemento>
      <bairro>[BAIRRO]</bairro>
      <cidade>[CIDADE]</cidade>
      <estado>[ESTADO]</estado>
      <pais>[PAIS]</pais>
      <cep>[CEP]</Cep>
      <telefone1>[TELEFONE 1]</telefone1>
      <telefone2>[TELEFONE 2]</telefone2>
      <telefone3>[TELEFONE 3]</telefone3>
      <celular>[CELULAR]</celular>
      <fax>[FAX]</fax>
  <infoadc1>[INFO 01]</infoadc1>
      <infoadc2>[INFO 02]</infoadc2>
      <infoadc3>[INFO 03]</infoadc3>
      <infoadc4>[INFO 04]</infoadc4>
      <infoadc5>[INFO 05]</infoadc5>
      <infoadc6>[INFO 06]</infoadc6>
      <infoadc7>[INFO 07]</infoadc7>
      <infoadc8>[INFO 08]</infoadc8>
      <infoadc9>[INFO 09]</infoadc9>
      <infoadc10>[INFO 10]</infoadc10>
      <infoadc11>[INFO 11]</infoadc11>
      <infoadc12>[INFO 12]</infoadc12>
      <infoadc13>[INFO 13]</infoadc13>
      <infoadc14>[INFO 14]</infoadc14>
      <infoadc15>[INFO 15]</infoadc15>
      <infoadc16>[INFO 16]</infoadc16>
      <infoadc17>[INFO 17]</infoadc17>
      <infoadc18>[INFO 18]</infoadc18>
      <infoadc19>[INFO 19]</infoadc19>
      <infoadc20>[INFO 20]</infoadc20>
    </destinatario>
    <destinatario>
      (...)
    </destinatario>
    (...)
  </emkt>
</main>

XML de envio estrutura básica

<main>
  <emkt trans="30.05">
    <automacao>[HASH]</automacao>
    <destinatario>
      <email>[EMAIL]</email>
    </destinatario>
   (...)
  </emkt>
</main>
>

XML de Retorno:

<MAIN>
  <EMKT TRANS="30.05" KEY="0a0001745188308e7d3c515bfd3d">
    <RETURN ID="00">Ok</RETURN>
  </EMKT>
</MAIN>

30.06 - Remover Contatos de uma Automação

Utilize essa integração para remover contatos de uma régua de relacionamento (automação).
Para implementar é necessário substituir na linha <automação> o código de exemplo pelo código da sua automação. Para encontrar o mesmo verifique o caminho na integração 30.05

XML de Envio

<main>
 <emkt trans="30.06">
   <automacao>ddf88ea64eaed0f3de5531ac964a0a1a</automacao>
    <destinatario>
      <email>exemplo@seudominio.com.br</email>
      <celular>11999999999</celular>
   </destinatario>
</emkt>
</main>

XML de retorno

<MAIN>
    <EMKT TRANS="30.06" KEY="xxxxxxxxxxxxxxxxxxxxxxxxx">
        <processo>[CODIGO MD5]</processo>
    </EMKT>
</MAIN>

30.07 - Consulta o Status da Remoção

Utilize essa integração para consultar o status da remoção de contatos de uma 'régua' de relacionamento(automação) efetuada na integração 30.06.

XML de Envio

<main>
 <emkt trans="30.07">
   <processo>[CODIGO MD5]</processo>
 </emkt>
</main>

XML de Retorno

<MAIN>
<EMKT TRANS="30.07" KEY="0ba0014c8b0bff96e5625487ddc5">
 <PROGRESSO>100</PROGRESSO>
  <MENSAGEM>Remoção efetuada com sucesso</MENSAGEM>
 </EMKT>
</MAIN>