# 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="../apis/outbound" %}
[outbound](https://docs.altu.d1.cx/connect/apis/outbound)
{% endcontent-ref %}

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

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MBjaNm5lB1Yqgih1JCA%2F-Ma-658y-RCyJwqp0sFG%2F-Ma-7G7jctIsKqFmHwdc%2Fwebhookwhats.png?alt=media\&token=2f170205-7c47-42d6-9ca6-1d7a4104eb5a)