{"section":"tutorials","requestedLocale":"pt","requestedSlug":"nocoes-basicas-sobre-integracoes","locale":"pt","slug":"nocoes-basicas-sobre-integracoes","path":"docs/pt/tutorials/weni-by-vtex/integrações/nocoes-basicas-sobre-integracoes.md","branch":"main","content":"Integração é a ação realizar busca, modificar ou enviar informações para um serviço. As integrações se subdividem em duas:\n\n- **Nativa**: A Weni plataforma consegue integrar com APIs que tem formato REST/Json através de um **cartão Webhook** ou através de uma aplicação pré-existente no menu de Integrações.\n- **Não-nativa**: Fazemos integrações não nativas para API's que não são REST/Json. Porém, nesse caso, devemos analisar o esforço e escopo da solicitação, visto que usamos serviços externos para consumir e modelar a API, por exemplo [Back4app](https://www.back4app.com/#) e [Pipedream](https://pipedream.com/).\n\n## O que é API?\n\nÉ uma forma de comunicação entre sistemas, em que um deles fornece informações e serviços que podem ser utilizados pelo outro (Weni Plataforma). Normalmente uma API possui:\n\n- URL\n- Documentação explicando como ela pode ser utilizada\n- Endpoints/recursos disponíveis\n- Formas de Autenticação para usar a API, se for necessário.\n\n## O que é webhook?\n\nWebhook é uma tecnologia utilizada para permitir a comunicação entre duas aplicações em tempo real. Na Weni Plataforma podemos buscar e até mesmo atualizar informações em outros sistemas através do cartão **Chamar Webhook**. Isso quer dizer que, para consumir uma API, você irá utilizar um cartão Webhook:\n\nPara passar informações para um sistema usando API você deve usar o corpo da requisição (body) ou passar diretamente na URL (query). A documentação da API vai dizer como deve ser feito.\n\nNessa imagem podemos ver a documentação da API da Weni:\n\nNesta imagem podemos ver como ficaria o corpo da requisição para criar um contato com nome e número de WhatsApp:\n\n> **Dica:** O card Chamar Webhook permite o uso de variáveis, como, por exemplo, @results @contact e @fields. [Saiba mais sobre variáveis aqui.](/pt/docs/tutorials/introducao-a-expressoes-e-variaveis)\n\n## Como saber se a API pode ser integrada nativamente?\n\nA documentação da API funciona como um manual que nos ajuda a entender como integrar. Nela será informado se as requisições são na arquitetura nativa da Weni plataforma: REST/Json.\n\n> **Nota:** Se a arquitetura da sua API não for REST/Json, ainda é possível fazer a integração, porém será necessário modelar essa API.\n\n## Como visualizar a chamada de API na Weni plataforma?\n\nPara visualizar o retorno da API, acesse o log de Webhooks no Módulo Fluxos:\n\nTem mais dúvidas sobre API? Joga na nossa [comunidade](https://comunidade.weni.ai/) 😉 Temos uma equipe especialista para tirar suas dúvidas."}