{"id":908,"date":"2024-11-01T21:58:54","date_gmt":"2024-11-01T21:58:54","guid":{"rendered":"https:\/\/tutoriais.tayon.ai\/?post_type=tesserakb&p=908"},"modified":"2024-11-01T22:05:05","modified_gmt":"2024-11-01T22:05:05","slug":"usando-webhooks-no-flow","status":"publish","type":"tesserakb","link":"https:\/\/tutoriais.tayon.ai\/?tesserakb=usando-webhooks-no-flow","title":{"rendered":"Usando Webhooks no Flow"},"content":{"rendered":"\n

O uso de webhooks e chamadas de API no flow \u00e9 um recurso extremamente poderoso e que faz a Tayon se destacatar de outras plataformas por conta da versatilidade e capacidade de integra\u00e7\u00e3o com praticamente qualquer outro sistema.
<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

1 – <\/strong>A URL externa da API ou Webhook que deve ser chamada.
2 – <\/strong>O tipo de envio que a API ou Webhook espera. Pode ser POST ou GET.
3 –<\/strong> A lista de par\u00e2metros que ser\u00e3o passados. Pode ser uma lista com um par\u00e2metro por linha ou um JSON v\u00e1lido (detalhes mais adiante).
4 – <\/strong>Cabe\u00e7alhos (headers) para a chamada. Geralmente um token de autoriza\u00e7\u00e3o ou outro header exigido pela API\/Webhook.
5 –<\/strong> Tipo de retorno que ser\u00e1 salvo no IDENTIFICADOR para este webhook. O retorno pode ser um c\u00f3digo HTTP (200, 404, 500, etc), um texto ou um JSON.

Exemplo de uma chamada completa:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Supondo que o c\u00f3digo da API na URL https:\/\/api.oneapptointegrate.com seja algo parecido com esse:<\/p>\n\n\n\n

<?php
\/\/ Set your secret token here
$secret_token = \"thesecrettokenfortheapi\";

\/\/ Get the authorization header
$headers = apache_request_headers();
if (!isset($headers['Authorization'])) {
http_response_code(401);
echo json_encode([\"error\" => \"Unauthorized\"]);
exit;
}

\/\/ Validate the bearer token
$authHeader = $headers['Authorization'];
list($token_type, $token) = explode(\" \", $authHeader);
if ($token_type !== \"Bearer\" || $token !== $secret_token) {
http_response_code(403);
echo json_encode([\"error\" => \"Forbidden\"]);
exit;
}

\/\/ Retrieve POST data
$name = $_POST['name'] ?? null;
$phone = $_POST['phone'] ?? null;
$email = $_POST['email'] ?? null;
$address = $_POST['address'] ?? null;

\/\/ Validate that required data is present
if (!$name || !$phone || !$email || !$address) {
http_response_code(400);
echo json_encode([\"error\" => \"Missing parameters\"]);
exit;
}

\/\/ Return data as JSON
$response = [
\"name\" => $name,
\"phone\" => $phone,
\"email\" => $email,
\"address\" => $address,
];

header(\"Content-Type: application\/json\");
echo json_encode($response);
?><\/code><\/p>\n\n\n\n

O resultado ser\u00e1 um JSON com os mesmos dados enviados. Parr recuperar os dados recebidos pelo webhook, basta usar o mesmo identificador como vari\u00e1vel no flow. Quando se trata de um JSON, os dados pode ser recuperados com o formato IDENTIFICADOR[atributo]. Veja exemplo abaixo:
<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Quando estiver testando o seu flow, voc\u00ea pode recuperar os dados de retorno no painel seguinte ao da chamada do webhook e mostrar o conte\u00fado no painel. Assim voc\u00ea pode verificar se a chamada deu certo ou se houve algum erro, por exemplo.

Supondo que voc\u00ea fa\u00e7a uma chamada de webhook apenas para envio de dados e n\u00e3o precisa do retorno para o seu flow. Nesse caso, voc\u00ea pode colocar o retorno como c\u00f3digo HTTP e no seu flow ter uma decis\u00e3o logo ap\u00f3s a a\u00e7\u00e3o do webhook que compara o retorno com 200. Se o retorno = 200, o webhook foi executado com sucesso. Se o retorno for diferente de 200 pode significar que houve um erro ou existe um problema nos par\u00e2metros, autentica\u00e7\u00e3o, etc. Se precisar dos detalhes, voc\u00ea pode temporariamente mudar o retorno para “texto” e verificar o conte\u00fado. A maioria das APIs e Webhooks enviam uma mensagem no corpo da p\u00e1gina de retorno com a descri\u00e7\u00e3o do resultado da chamada ou um JSON com esses detalhes. Nos dois casos, ao setar o retorno como “texto” voc\u00ea poder\u00e1 exibir o conte\u00fado do identificador usado no webhook no painel seguinte e verificar o retorno.

Tamb\u00e9m \u00e9 poss\u00edvel passar um JSON como par\u00e2metro para a API\/Webhook quando for necess\u00e1rio. Exemplo:
<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

IMPORTANTE: O uso de webhooks e chamadas de API \u00e9 um recurso avan\u00e7ado. Voc\u00ea deve conhecer os conceitos e saber o que est\u00e1 fazendo, caso contr\u00e1rio dados podem ser perdidos ou contas bloqueadas em outros apps. A Tayon n\u00e3o se responsabiliza pelo uso indevido de webhooks.<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"

O uso de webhooks e chamadas de API no flow \u00e9 um recurso extremamente poderoso e que faz a Tayon se destacatar de outras plataformas por conta da versatilidade e capacidade de integra\u00e7\u00e3o com praticamente qualquer outro sistema. 1 – A URL externa da API ou Webhook que deve ser chamada.2 – O tipo de…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"tessera_post_format_link":""},"tesserakbcats":[38],"tesserakbtags":[65,59,63,60,72,66],"class_list":["post-908","tesserakb","type-tesserakb","status-publish","format-standard","hentry","tesserakbcats-conversational-flows","tesserakbtags-api","tesserakbtags-automation","tesserakbtags-flow-designer","tesserakbtags-flow","tesserakbtags-conversational-flow","tesserakbtags-webhook"],"_links":{"self":[{"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=\/wp\/v2\/tesserakb\/908","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=\/wp\/v2\/tesserakb"}],"about":[{"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=\/wp\/v2\/types\/tesserakb"}],"author":[{"embeddable":true,"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=908"}],"wp:attachment":[{"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=908"}],"wp:term":[{"taxonomy":"tesserakbcats","embeddable":true,"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Ftesserakbcats&post=908"},{"taxonomy":"tesserakbtags","embeddable":true,"href":"https:\/\/tutoriais.tayon.ai\/index.php?rest_route=%2Fwp%2Fv2%2Ftesserakbtags&post=908"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}