# Whatsapp

Antes de criar uma integração com o canal WhatsApp do Facebook, certifique-se que a sua empresa foi inclusa na prévia pública limitada da WhatsApp Business API.

Caso sua empresa não tenha acesso à API do WhatsApp Business, poderá solicitar a inclusão acessando <https://www.facebook.com/business/m/whatsapp/business-api>.

Como administrador, crie uma conta de usuário em seu cliente WhatsApp Business que será vinculado à esta integração. Na plataforma Zenvia NLU, vá em **Connect > Canais > WhatsApp**, clique no botão "**+"** para criar uma nova integração e preencha os seguintes campos:

* **Nome:** nome da sua integração
* **Assistente:** o assistente que será vinculado à essa integração
* **Squad**: o grupo de usuários que terá acesso a este recurso
* **URL WhatsApp:** URL do cliente da API WhatsApp Business
* **Usuário WhatsApp:** nome de usuário da conta de usuário a ser utilizada
* **Senha WhatsApp:** senha da conta de usuário a ser utilizada
* **Mensagens para mídias não suportadas:** mensagens que serão enviadas caso o usuário realize upload de algum arquivo não aceito
* **Telefones de Homologação:** telefones para teste do fluxo de atendimento

Após criar a integração, volte para a tela de **Integrações com WhatsApp** e clique no botão de editar integração para consultar suas URLs de Webhook. A URL **Entrada de Mensagens** deverá ser chamada para notificar mensagens enviadas por clientes de seu negócio.

Além disso, através do Zenvia NLU, é possível integrar com o WhatsApp business com os seguintes brokers:

* Wavy
* Liveperson
* Infobip
* Blip

## WhatsApp: Envio de Localização

Com o sistema de busca de localização, após o usuário informar seu endereço, é possível consultar as informações de latitude e longitude. Essa funcionalidade também pode ser associada a outros códigos, como a API do Google Maps, para aprimorar a busca.\
\
A localização do usuário fica disponível por meio do comando **input.location** quando o **input.text** for "ALTU\_LOCATION". Em algumas ocasiões é possível que atributos (como o name, address e url) não sejam disponibilizados pelo canal em que o chat está associado.

### Exemplo

```
{
    "text": "ALTU_LOCATION",
    "location": {
        "latitude": 38.9806263495,
        "longitude": -131.9428612257,
        "address": "Main Street Beach, Santa Cruz, CA",
        "name": "Main Street Beach",
        "url": "https://foursquare.com/v/4d7031d35b5df7744"
    }
}
```

| Nome          | Descrição                                                         | Tipo   |
| ------------- | ----------------------------------------------------------------- | ------ |
| **latitude**  | Latitude da localização enviada                                   | Number |
| **longitude** | Longitude da localização enviada                                  | Number |
| **address**   | Endereço do local                                                 | String |
| **name**      | Nome do local                                                     | String |
| **url**       | URL do site em que o usuário baixou as informações de localização | String |

Aqui estão as informações que podem ser acessadas por cada source de WhatsApp:

|           | **WhatsApp** | **Blip** | **Liveperson** | **Wavy** | Infobip | Zenvia |
| --------- | ------------ | -------- | -------------- | -------- | ------- | ------ |
| latitude  | x            | x        | x              | x        | x       | x      |
| longitude | x            | x        | x              | x        | x       | x      |
| address   | x            |          |                | x        | x       | x      |
| name      | x            | x        |                | x        | x       | x      |
| url       | x            |          |                |          | x       | x      |

## Webhook para WhatsApp

Para configurar o se webhook, acesse:

{% content-ref url="/pages/-MYKOlNeJMEQHDHh-AiB" %}
[Outbound](/connect/apis/outbound.md)
{% endcontent-ref %}

Para essa integração, só é necessário a URL:&#x20;

![](/files/-Ma-7G7jctIsKqFmHwdc)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.altu.d1.cx/connect/canais/whatsapp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
