> ## Documentation Index
> Fetch the complete documentation index at: https://developers.datafyapi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar localização

> Envie um ponto no mapa com nome e endereço.

Envia uma localização para um cliente com a [janela de 24 horas](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#janela-de-24-horas) aberta. O cliente vê o ponto no mapa e pode abrir o local no aplicativo de mapas do celular.

> [!NOTE]
>
> O destinatário pode ser informado pelo **número de telefone** (`to`) ou pelo **ID do usuário** (`recipient`). Se os dois forem enviados, vale o `to`; para enviar pelo ID do usuário, deixe o `to` em branco. Veja a diferença em [Destinatário](https://developers.datafyapi.com.br/api-reference/whatsapp/mensagens/introducao.md#destinatário).

## Coordenadas

`location.latitude` e `location.longitude` são obrigatórios e usam **graus decimais**, como `-23.561414` e `-46.655881`. No Brasil, os dois valores são negativos.

`location.name` e `location.address` são opcionais e ajudam o cliente a identificar o local.

> [!TIP]
>
> Para pegar as coordenadas de um endereço, abra o Google Maps, clique com o botão direito no local e clique nos números que aparecem no topo do menu. Eles são copiados no formato `latitude, longitude`.

No **Testar**, a localização já vem preenchida com o MASP, na Avenida Paulista. Troque pelas coordenadas do seu local.

Veja mais detalhes na [documentação de mensagens de localização da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/messages/location-messages).


## OpenAPI

````yaml api-reference/whatsapp/specs/localizacao.json POST /v1/{phone_number_id}/messages
openapi: 3.1.0
info:
  title: Datafy API — Enviar localização
  version: 1.0.0
servers:
  - url: https://cloud.datafyapi.com.br
    description: Produção
security:
  - bearerAuth: []
paths:
  /v1/{phone_number_id}/messages:
    post:
      summary: Enviar localização
      operationId: enviarLocalizacao
      parameters:
        - name: phone_number_id
          in: path
          required: true
          schema:
            type: string
          description: ID do número que envia a mensagem. Descubra com `GET /me`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MensagemLocalizacao'
            example:
              messaging_product: whatsapp
              recipient_type: individual
              to: '5511999999999'
              type: location
              location:
                latitude: '-23.561414'
                longitude: '-46.655881'
                name: MASP
                address: Av. Paulista, 1578 - Bela Vista, São Paulo - SP
      responses:
        '200':
          description: Envio aceito pela Meta. Não confirma a entrega.
          content:
            application/json:
              example:
                messaging_product: whatsapp
                contacts:
                  - input: '5511999999999'
                    wa_id: '5511999999999'
                messages:
                  - id: wamid.HBgNNTUxMTk5OTk5OTk5ORUCABIYFjNFQjA=
        '400':
          description: Erro retornado pela Meta.
          content:
            application/json:
              example:
                error:
                  message: (#100) Invalid parameter
                  type: OAuthException
                  code: 100
                  fbtrace_id: AbCdEfGhIjK
        '401':
          description: Token ausente ou inválido.
          content:
            application/json:
              example:
                statusCode: 401
                message: Token inválido ou não encontrado.
components:
  schemas:
    MensagemLocalizacao:
      type: object
      required:
        - messaging_product
        - to
        - type
        - location
      properties:
        messaging_product:
          type: string
          enum:
            - whatsapp
          default: whatsapp
          example: whatsapp
          description: Sempre `whatsapp`.
        recipient_type:
          type: string
          enum:
            - individual
          default: individual
          example: individual
          description: Sempre `individual`.
        to:
          type: string
          example: '5511999999999'
          description: >-
            Número do destinatário com código do país e DDD, como
            `5511999999999`. Tem prioridade sobre `recipient`: para enviar pelo
            ID do usuário, deixe em branco.
        recipient:
          type: string
          description: >-
            ID do usuário no WhatsApp (BSUID), recebido nos webhooks em
            `from_user_id` e `contacts[].user_id`, como
            `BR.13491208655302741918`. Usado quando `to` não é informado.
        type:
          type: string
          enum:
            - location
          default: location
          example: location
          description: Sempre `location`.
        location:
          type: object
          required:
            - latitude
            - longitude
          description: Ponto no mapa enviado ao cliente.
          properties:
            latitude:
              type: string
              example: '-23.561414'
              description: >-
                Latitude em graus decimais. No hemisfério sul, como no Brasil, o
                valor é negativo.
            longitude:
              type: string
              example: '-46.655881'
              description: >-
                Longitude em graus decimais. A oeste de Greenwich, como no
                Brasil, o valor é negativo.
            name:
              type: string
              example: MASP
              description: Nome do local exibido na mensagem.
            address:
              type: string
              example: Av. Paulista, 1578 - Bela Vista, São Paulo - SP
              description: Endereço do local exibido na mensagem.
        context:
          type: object
          description: Responde citando uma mensagem anterior da conversa.
          properties:
            message_id:
              type: string
              description: ID (`wamid`) da mensagem que será citada.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token gerado no painel da Datafy ao criar o canal. Formato:
        `sk_live_xxx`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.