olxbr/crm-lead-integration

crm-lead-integration's Issues

Dúvida - Como faço para solicitar esta 'SECRET_KEY'?

Dúvidas sobre Portais

Bom dia, esta integração serve para todos os portais, ZAP e VIVA REAL? Ou cada portal teria um Endpoint separado?

Gostaria de exemplos em PHP

Olá amigos bom dia,
Estou no site lendo a documentação enquanto crio o arquivo para receber o POST.
No manual vem escrito "Todas as nossas requisições de integração de leads contém o header Authorization com informações"
Porém, quando acesso o "Validador de Endpoint de Leads" ele envia uma requisição sem esse "header Authorization"
Abaixo segue var_dump do que estou recebendo no $_SERVER

array(48) {
["PATH"]=> string(28) "/usr/local/bin:/usr/bin:/bin"
["TZ"]=> string(17) "America/Fortaleza"
["REDIRECT_HANDLER"]=> string(28) "application/x-httpd-ea-php73"
["REDIRECT_STATUS"]=> string(3) "200"
["UNIQUE_ID"]=> string(27) "ZG-8PfgQGUwjEMz1RvaSYAAAANU"
["SCRIPT_URL"]=> string(25) "/leads/leads_canalpro.php"
["SCRIPT_URI"]=> string(50) "https://gestaoimoveis.com/leads/leads_canalpro.php"
["HTTPS"]=> string(2) "on"
["SSL_TLS_SNI"]=> string(17) "gestaoimoveis.com"
["HTTP_HOST"]=> string(17) "gestaoimoveis.com"
["HTTP_SENTRY_TRACE"]=> string(51) "ec6be610ae30458c89996f8b08ac7734-a8bee10531b7b203-0"
["HTTP_BAGGAGE"]=> string(181) "sentry-trace_id=ec6be610ae30458c89996f8b08ac7734,sentry-environment=production,sentry-public_key=b08495ed81264769bf34936aeed17f7b,sentry-transaction=/sandbox/leads/send-a-lead-to-me"
["HTTP_USER_AGENT"]=> string(13) "inception-api"
["HTTP_ACCEPT_ENCODING"]=> string(13) "gzip, deflate"
["HTTP_ACCEPT"]=> string(16) "application/json"
["HTTP_CONNECTION"]=> string(10) "keep-alive"
["CONTENT_TYPE"]=> string(16) "application/json"
["CONTENT_LENGTH"]=> string(3) "359"
["HTTP_X_HTTPS"]=> string(1) "1"
["SERVER_SIGNATURE"]=> string(0) ""
["SERVER_SOFTWARE"]=> string(6) "Apache"
["SERVER_NAME"]=> string(17) "gestaoimoveis.com"
["SERVER_ADDR"]=> string(15) "162.240.208.140"
["SERVER_PORT"]=> string(3) "443"
["REMOTE_ADDR"]=> string(12) "35.173.9.239"
["DOCUMENT_ROOT"]=> string(32) "/home/imobsy06/gestaoimoveis.com"
["REQUEST_SCHEME"]=> string(5) "https"
["CONTEXT_PREFIX"]=> string(8) "/cgi-sys"
["CONTEXT_DOCUMENT_ROOT"]=> string(26) "/usr/local/cpanel/cgi-sys/"
["SERVER_ADMIN"]=> string(38) "[email protected]"
["SCRIPT_FILENAME"]=> string(57) "/home/imobsy06/gestaoimoveis.com/leads/leads_canalpro.php"
["REMOTE_PORT"]=> string(5) "37650"
["REDIRECT_URL"]=> string(25) "/leads/leads_canalpro.php"
["GATEWAY_INTERFACE"]=> string(7) "CGI/1.1"
["SERVER_PROTOCOL"]=> string(8) "HTTP/1.1"
["REQUEST_METHOD"]=> string(4) "POST"
["QUERY_STRING"]=> string(0) ""
["REQUEST_URI"]=> string(25) "/leads/leads_canalpro.php"
["SCRIPT_NAME"]=> string(25) "/leads/leads_canalpro.php"
["ORIG_SCRIPT_FILENAME"]=> string(34) "/usr/local/cpanel/cgi-sys/ea-php73"
["ORIG_PATH_INFO"]=> string(25) "/leads/leads_canalpro.php"
["ORIG_PATH_TRANSLATED"]=> string(57) "/home/imobsy06/gestaoimoveis.com/leads/leads_canalpro.php"
["ORIG_SCRIPT_NAME"]=> string(17) "/cgi-sys/ea-php73"
["PHP_SELF"]=> string(25) "/leads/leads_canalpro.php"
["REQUEST_TIME_FLOAT"]=> float(1685044285.2176)
["REQUEST_TIME"]=> int(1685044285)
["argv"]=> array(0) { }
["argc"]=> int(0)
}

Eu coloquei que o token deveria ser AAAAAAAAAAAAAAAAAAAAA para ver se ficava em evidencia mas não acho em lugar nenhum.

Acho incrível ter exemplos de todos os jeitos menos PHP

Alguém consegue um script simples de como deve ser essa validação do token ?

Endpoint parou de receber leads

Olá,

Nosso webhost teve problemas e ficamos um dia com o sistema fora do ar. Recebemos os e-mail do grupo zap informando sobre o erro na integração de leads (pois nosso sistema estava fora do ar).

Após o retorno do nosso sistema, os leads não estão mais chegando ao nosso endpoint. Ao testar o endpoint com o Postman, tudo funciona normalmente.

Há ainda alguma verificação que devemos fazer?

Ajuda para integração com PHP

Alguém poderia me mandar um exemplo do Script que recebe a requisição que eles enviam por post e salva o lead e um txt?
estou no email [email protected]

Retornar 404 para integração de leads não existente não impede novas requisições

Após um cliente cancelar ou desfazer a integração através do meu CRM, o que devo retornar em futuras chamadas de API?

Atualmente é dado uma resposta com o status http 404 porém não é o suficiente para impedir novas requisições.

Posso usar ferramenta de integração?

Olá,

Utilizo www.integromat.com para integração de Leads com CRM. Ele gera uma url de webhook tipo essa: https://hook.integromat.com/29dffqtkelv4tuwfrvkurl0vqfcgro6t para receber as informações.

Seria possível utilizar um endereço como esse para receber os dados de vocês?

Dúvidas sobre a homologação e SECRET_KEY

Olá, eu tenho uma dúvida sobre a homologação.Caso eu tenha um Enpoint com o id do anunciante ex:https://ID-DO-ANUNCIANTE.yourdomain.com.br/grupozap/lead eu tenho que enviar um e-mail contendo todos os Enpoints de cada anunciante ou enviar um e-mail para cada?.

E o SECRET_KEY será de cada Enpoint?,

Eu irei receber o SECRET_KEY como resposta ao e-mail ou eu tenho que requisitar separadamente após a homologação?

Envio do ListingID enviado pelo parceiro no xml da carga

Bom dia!
Trabalho com a carga de imóveis usando XML. Um dos atributos que é enviado é o ListingID, que corresponde ao código do imóvel no nosso ERP.
Seria possivel adicionar essa informação junto na carga de leads, de acordo com imóvel que o lead veio?

Problemas com o processo de homologação

Olá, boa tarde,

Eu represento o SimobCRM e quarta-feira(15) nós enviamos um e-mail para [email protected] com as informações necessárias para fazer a homologação e ainda não obtivemos uma resposta. Gostaria de saber quanto tempo vai levar para nos retornar com uma resposta.

Iniciando testes de Integração

Olá, boa tarde!

Estamos iniciando os testes de integração de lead com o ZAP. Acabamos de enviar um e-mail para [email protected], como solicitado nas instruções.

Gostaria de saber melhor quanto tempo, em média, demora para habilitarmos a integração ?

Webhook Zap: Problema demora/delay no envio do evento de novo lead

Prezados, somos software parceiro e o ZAP está enviando o evento de novo lead via webhook com grande demora (~6 horas depois) no envio de evento via webhook. Conversando com outros softwares parceiros estão com o mesmo problema. Gostaria de saber se a equipe de tecnologia está realmente ciente do problema e qual previsão de normalização.

https://developers.grupozap.com/webhooks/integration_leads.html#envio-dos-leads

Obrigado e precisando de qualquer informação adicional, estou à disposição.

Dúvidas sobre homologação e configuração pelos meus clientes

Olá!
Já validei o endpoint de minha aplicação mas ainda tenho 2 dúvidas antes de enviar para homologação:

1. Estou adotando a opção da url 1 "https://yourdomain.com.br/grupozap/lead/ID-DO-ANUNCIANTE" e seria esta url que devo informar para homologação. Entretanto, cada cliente de meu CRM tem um ID-DO-ANUNCIANTE diferente em minha aplicação, o que me permite identificar para qual empreendimento o lead recebido deve ser direcionado. Entendo que a homologação valida o endpoint "https://yourdomain.com.br/grupozap/lead/", ou seja, não precisaremos passar pela homologação para cada cliente que decidir integrar meu CRM com o grupo ZAP, certo?
2. Poderia me passar informações de como cada anunciante no grupo ZAP configura em sua conta no grupo ZAP a ativação da integração?
   Obrigado,

Como obter a Secret key?

Preciso obter a secret key, como faço isso?

Featured no Payload JSON

Olá!
Minha equipe tem uma demanda de receber no payload do webhook um campo descrevendo se um anúncio foi passado como Featured no xml que foi processado em batch. Não é interessante, por exemplo, consultarmos nossa base de dados no momento que recebemos a notificação pois em nosso sistema o anúncio pode já não estar mais em destaque.
Existe alguma forma de fazer isso da forma como o JSON é hoje?
Caso não exista, seria algo que vocês colocariam no roadmap?
Muito obrigado!

Duvida

Fiz a integração com vocês, porém, quando feito um pedido em algum anuncio, eu mando mostrar tudo que chega para o meu arquivo que veio atraves do post, e ele me retorna somente o numero 1, nada mais alem disso...

Segue meu codigo:

$escreve = fwrite($fp, "Dados do post: ".print_r($_POST));
$escreve = fwrite($fp, "Recuperando dados passados por POST:");

//RECEBE VALORES POST
$leadOrigin = $_POST['leadOrigin'];
$timestamp = $_POST['timestamp'];
$originLeadId = $_POST['originLeadId'];
$originListingId = $_POST['originListingId'];
$clientListingId = $_POST['clientListingId'];
$name = $_POST['name'];
$email = $_POST['email'];
$ddd = $_POST['ddd'];
$phone = $_POST['phone'];
$phoneNumber = $_POST['phoneNumber'];
$message = $_POST['message'];

Dúvida sobre o campo ID-DO-ANUNCIANTE

O campo ID-DO-ANUNCIANTE é o id do anunciante no grupo zap, ou o id do anunciante no CRM?

Problema na homologação da integração

Boa tarde, nossa empresa precisa de um secret key para nosso CRM, já respondemos o formulário que consta na documentação, mas nunca recebemos resposta. Quando tento enviar e-mail para [email protected], o e-mail volta. Com quem podemos falar para resolver esse problema?

Duvida - Arquivo de Importação de Anunciantes em Lote

Enviando o arquivo CSV para [email protected] com os dados dos clientes eu estarei me inscrevendo para receber os leads apenas desses clientes?

Se sim, para adicionar novos clientes só preciso reenviar o CSV para passar a receber os leads gerados nos seus imoveis?

Resumindo como faço para receber apenas os leads de um conjunto de clientes?
E como adicionar e remover dinamicamente essa lista de clientes?

Problema de homolagação

Boa tarde, nossa empresa precisa de um secret key para nosso CRM, já respondemos o formulário que consta na documentação, mas nunca recebemos resposta. Quando tento enviar e-mail para [email protected], o e-mail volta. Com quem podemos falar para resolver esse problema?

DÚVIDA SOBRE MANUAL

Boa tarde,

Estou fazendo a integração de LEADS, porém durante o desenvolvimento encontrei outro manual de leads na RDSTATION e nele existe um campo a mais :

originListingTitle: nome do imóvel do anúncio.

URL do manual: https://ajuda.rdstation.com.br/hc/pt-br/articles/360026269391-Como-integrar-com-VivaReal-Zap-Im%C3%B3veis-

Já neste manual aqui no GIT não encontrei este campo, qual seria o correto ?

Minha segunda dúvida é se tem como eu saber se o imóvel que veio é de VENDA ou se é de LOCAÇÃO durante a chamada com o LEAD ? Caso sim, como posso pegá-lo, não encontrei no manual.

Envio dos Leads - mais informações

Bom dia !

Gostaria de solicitar que no "Contrato JSON", enviado para os sistema que fazem a integração com o grupozap também seja enviado o departamento, por exemplo, venda ou locação.

Obrigado.

Ola!

Peço, por favor que sejam mais claros na documentação desta API, há muita informação vaga, seria bom se tivesse um exemplo ou algo assim...

Dúvida de Integração

Gostaria de sanar uma dúvida sobre o que acontece com aqueles imóveis que já estão publicados manualmente no portal, quando finalizada a integração do XML com os imóveis? Gostaria de saber se eles são inativados ou continuam em anúncio.

Dúvida sobre a integração

Boa tarde amigos,

Dei uma lida na documentação de vocês sobre a integração de Leads junto ao sistema de vocês, porém estou com dúvida neste trecho:

"Estamos disponibilizando neste repositório o manual de Integração de Leads do Grupo Zap. Este documento contém as informações básicas para os Softwares/CRM realizarem as integracões com nosso sistema afim de receber os leads gerados nos portais do GrupoZap (VivaReal e ZapImoveis). Basicamente nosso sistema de integração de leads precisa de uma URL (Endpoint) para enviar as informações do lead para os softwares homologados, esta requisição será realizada via protocolo HTTP no verbo POST no Endpoint especificado passando um JSON como corpo do request."

A integração é apenas dos Leads gerados a partir dos portais de vocês ? Mas como eu vou criar essas requisições nos portais de vocês ? No meu entendimento eu controlaria os Leads gerados a partir do site da MINHA imobiliária e enviaria para o sistema de vocês a fim de gerencia-los lá. Não seria assim ? Podem me explicar, obrigado !

Alteração de email de recebimento de leads

Olá!
Existe uma forma de alterar o email que recebe os leads com falha de entrega?
Tentei usar o formulário de cadastro para isso mas não sei se é a melhor forma.
Obrigado.

Duvida sobre importação de anunciantes

Bom dia.

Eu olhei na documentação de vocês que após a homologação ira ser necessário enviar um arquivo csv com todos os anunciantes que possuem integração com os portais ZAP ou VivaReal.

Porem eu queria saber como ira ser após isso com os novos clientes que forem ativando a integração?
Eu vou precisar enviar o arquivo .csv só com o cliente que ativou a integração, ou com todos os clientes novamente?

Problema na homologação de endpoint

Enfrentamos um problema na validação do endpoint no site, e estamos buscando realizar testes em nosso endpoint.

Com qualquer endopoint que testamos (até mesmo os de teste), a seguinte mensagem é apresentada na tela:

Seria possível nos fornecer assistência nesse processo?

Dúvida sobre o endpoints

É feita essa informação "Abaixo exemplos de endpoints que poderão ser utilizados:", neste caso não poderemos utilizar outro, tipo: https://meudominio.net/servicos/portal/grupozap/lead/12345

Integração de Leads - Id do anunciante via Query Params

Na documentação do envio de leads, as 2 formas possíveis de enviar o id do anunciante é via path (https://yourdomain.com.br/grupozap/lead/ID-DO-ANUNCIANTE) ou via url (https://ID-DO-ANUNCIANTE.yourdomain.com.br/grupozap/lead).

Gostaria de saber, se é possivel enviar ele via Query String, no formato: https://yourdomain.com.br/grupozap/lead?idAnunciante=ID-DO-ANUNCIANTE

Outra duvida, a secret key que vcs enviam na autenticação (https://github.com/grupozap/crm-lead-integration/wiki/Como-Validar-Seguran%C3%A7a-SECRET_KEY) é 1 por cliente/integração ou 1 por integradora (nós) independente dos clientes?

Solicitação de SECRET_KEY e testes

Realizei a solicitação da secret_key por e-mail, mas não obtive nenhum retorno, gostaria de saber se está tudo certo com o endpoint enviado.

Esclarecimento

Gostaria de entender sobre a integração entre CRM e o ZAP e Viva Real.

A integração será dos leads gerados dentro dos sites do ZAP e/ou Viva Real para o CRM da imobiliária ?

Caso positivo onde teremos que incluir o código ? E poderemos usar o Sua House como CRM ?

Integração

Bom dia sou da equipe de desenvolvimento da SmartStaff,
Gostaria de saber como funciona a integração e como deve ser gerado a url, se possivel direcionar a resposta ao email: [email protected]
Obrigado desde já.

[Dúvida] - Integração com mais de um cliente

Olá!
Faço parte da equipe de um software de pré-venda que atende mais de uma empresa que faz uso dos portais do Grupo Zap.

Analizando os endpoits de vocês, gostaria de alinhar alguns pontos para saber se entendi corretamente e tirar algumas dúvidas:

• O ID-DO-ANUNCIANTE será relacionado com o ID do usuário do cliente presente em meu software, correto? Como vocês reconheceriam esta relação? E no caso de não informar o ID-DO-ANUNCIANTE pela url, qual seria a resposta obtita pela requisição e como faria para vincular com o ciente em meu software?

• Após prepararmos nosso sistema para receber os dados de vocês lhes fornecermos a url, os leads das plataformas do Grupo Zap cairão em nosso sistema através de um Webhook, correto.

• Em meu entendimento, o campo clientListingId seria o identificador do negócio. Através deste identificador, consigo por algum endpoint trazer mais dados sobre o mesmo?
  Exemplo.: Link da página e tipo do anúncio (locação ou venda) ?

Desde já agradeço.
Att,

Problema no recebimento de leads pelo email. ZAP VIVA REAL OLX

Gostaria de um contato para solucionar a situação. Grato

Dúvida integração XML no formato VRSync (Vivareal)

Olá,

Na documentação não encontrei os atributos para informar "Nº de andares" e "Nº de torres".

E através do cadastro manual pelo Canal Pro é possível inserir essas informações.

É possível cadastrar esses atributos através da integração XML?

Obrigado!

Problemas no recebimento de Leads

Boa tarde,
Faço parte de uma empresa que realiza a integração com o grupoZap, não tivemos problemas com a criação do webhook e seu manual está muito bem detalhado em relação as funções. No entanto, notamos que alguns clientes nossos começaram a reclamar que não estavam recebendo os leads no sistema, reparamos que são casos mais isolados, pois recebemos centenas por dia via a integração. Após uma análise, descobrimos que em alguns casos vocês estão enviando como método GET quando o correto seria um método POST.
Tenho como exemplo um teste que realizamos na empresa 343626.
{
"clientListingId": "CA000147",
"email": "[email protected]",
"leadOrigin": "VivaReal",
"message": "Teste de integração, favor desconsiderar.",
"name": "Teste PJ",
"originLeadId": "5ca649a6e4b0bfb52d2e1f61",
"originListingId": "2436508634",
"ddd": "",
"phone": "",
"phoneNumber": "",
"timestamp": "2019-04-04T18:15:02.331Z"
}
Criamos uma rota para o método GET e graças a isso foi possível que a nossa api começa-se a responder um erro 500 ao invés de 404. Porém ainda não é possível ler o "body", acredito que por se tratar de um GET não seja possível receber essa informação, pois ela vem apenas um JSON vazio {}.
Estamos no aguardo para resolvermos esse problema, pois eu já enviei um e-mail e não obtive resposta.
Qualquer dúvida estou a disposição.

erro BAD_CREDENTIALS ao passar cliennt_id e client_secret via curl

Estou tentando fazer a authenticação porém recebo como erro bad credentiaçs

curl
-XPOST
-v https://account-api.grupozap.com/oauth/token
-d 'grant_type=client_credentials&client_id=<CLIENT_ID>&client_secret=<CLIENT_SECRET>&scope=v2 read write

poderiam me orientar para qual url eu devo fazer a validação