Como utilizar a api_key?

10

Comments

10 comments

  • Avatar
    Guilherme Grando (Edited )

    Bom dia, Cesar,

    Sobre a sua dúvida, a API KEY é realmente exclusiva para o envio de conversões, dá uma olhada aqui neste link para saber qual usar: Quando utilizar a autenticação “API KEY” ou “Oauth"

    Agora, falando do erro que você recebeu, ele está indicando a ausência de campos obrigatórios, que hoje são esses aqui:

     

    No seu caso, está faltando o parâmetro email, que é responsável por carregar diretamente o e-mail do contato, e o parâmetro conversion_identifier, que é responsável por carregar o identificador de conversão.

    Uma conversão é quando uma determinada pessoa se torna Lead da sua base, por exemplo, ao preencher o formulário de orçamento do site uma conversão é gerada na conta.

    Para ficar mais claro, veja um exemplo de conversão abaixo:

    Ali onde está escrito "Orçamento" é o identificador da conversão.

    Ah, lembrando uma conversão cria ou atualiza um contato, e a chave para fazer isso é o e-mail do Lead 👍

    0
    Comment actions Permalink
  • Avatar
    Cesar

    Adicionei um email e informei um "conversion_identifier" para servir como identificador, mas não sei se posso fazer dessa maneira, o que está errado é o conversion_identifier mesmo, se sim como consigo corrigir?

    curl -X POST 'https://api.rd.services/platform/conversions?api_key=[api_key]' -H 'Content-Type:application/json' -d '{"event_type":"CONVERSION", "event_family":"CDP", "email": "cesar@videofront.com.br", "conversion_identifier": "Testing"}'

    Retorno:

    {"errors":[{"error_type":"MISSING","error_message":"Must be provided.","validation_rules":{},"path":"$.payload"}]}

     

    1
    Comment actions Permalink
  • Avatar
    Guilherme Grando

    Neste caso, o erro está indicando que a request executada está incorreta.

    Essa é a estrutura atual de uma requisição (somente com e-mail e identificador de conversão):

    { "event_type": "CONVERSION", "event_family":"CDP", "payload": { "conversion_identifier": "Testing", "email": "cesar@videofront.com.br"}}

    Note que na sua chamada o "payload" está ausente. 

    1
    Comment actions Permalink
  • Avatar
    Cesar

    Funcionou, brigadão 

    1
    Comment actions Permalink
  • Avatar
    Contato

    Tive o exato mesmo problema que o Cesar, mas usando OAuth2..

    {"errors":[{"error_type":"MISSING","error_message":"Must be provided.","validation_rules":{},"path":"$.body"}]}

    Com esse request:

    Procurei em toda a documentação mas não consegui encontrar nada :(

    Tem uma luz? hehehe

    0
    Comment actions Permalink
  • Avatar
    Contato

    E quando tento usar o UPSERT para o e-mail, obtenho isto:

     

    0
    Comment actions Permalink
  • Avatar
    Guilherme Grando

    Olá. 


    A API do RD Station Marketing conta com os métodos: POST, PUT, DELET e GET.

    A API key somente aceita POST, conforme documentação: https://developers.rdstation.com/pt-BR/authentication#conversionEventPostDetails 


    Sugiro você validar se o seu post concorda com as descrições da documentação acima. 

     

    Abraços

     

    0
    Comment actions Permalink
  • Avatar
    Contato

    Boa tarde!

    Sim, estou enviando via POST, consulta por exemplo está retornando normal, mas cadastro de novos leads não.

    Este aqui é o PHP do primeiro exemplo, que retorna o tal "validation_rules" para "$.body"

     

    0
    Comment actions Permalink
  • Avatar
    Eduardo

    Esta retornando esse erro aqui

    "error_type":"UNABLE_TO_LOAD_CDP_SCHEMA",
    "error_message":"Unable to load schema for tenant_id '225000000001448711'"
     
    Enviando isso aqui no body
    { "event_type": "CONVERSION", "event_family":"CDP", "payload": { "conversion_identifier": "Testing", "email": "teste@teste.com.br"}}
     
    O que pode ser?
     
    0
    Comment actions Permalink
  • Avatar
    Jade Leme

    Boa tarde Eduardo, tudo bem?

    Recomendo que abra um chamado na Central de Ajuda através do botão "Fale conosco" ao final da página! Encaminhando o máximo de detalhes sobre o problema citado, nosso time de suporte pode iniciar uma investigação mais assertiva através dos seus dados, sem tornar pública nenhuma informação sensível. Combinado?

    Obrigada por sinalizar a sua dúvida, e sempre que precisar conte conosco!

    0
    Comment actions Permalink


Please sign in to leave a comment.