# Slack Integration

The Tomba Slack integration allows you to search, verify, and enrich professional email addresses without leaving your Slack workspace.

---

## Features

With this integration, you can:

- 🔍 **Find emails** by domain or name
- **Verify** email deliverability
- 🔗 **Enrich** emails with company and profile information
- 🧑‍💼 **Discover authors** from article URLs
- 🔎 **Look up LinkedIn** profiles and emails

---

## File Structure

| File            | Description                         |
| --------------- | ----------------------------------- |
| `manifest.json` | Slack app manifest for installation |

---

## Slack Commands

After installing the Tomba Slack app, use the following commands:

| Slash Command      | Function                                       |
| ------------------ | ---------------------------------------------- |
| `/search <domain>` | Search for emails on a specific domain         |
| `/checker <email>` | Check if an email is valid and deliverable     |
| `/enrich <email>`  | Get full enrichment data on an email address   |
| `/author <url>`    | Extract author's email from a blog/article URL |
| `/linkedin <url>`  | Find emails from a LinkedIn profile URL        |

---

## Example Usage

```bash
/search tomba.io
/checker m@wordpress.org
/enrich m@wordpress.org
/author https://clearbit.com/blog/company-name-to-domain-api
/linkedin https://www.linkedin.com/in/mattm
```

---

## Installation via Slack Manifest

Use the following `manifest.json` to manually install the app in your Slack workspace:

```json
{
    "display_information": {
        "name": "Tomba Email Finder",
        "description": "Command utility to search or verify lists of email addresses in minutes",
        "background_color": "#1853db",
        "long_description": "Command utility to search or verify lists of email addresses in minutes can significantly improve productivity and efficiency for individuals and businesses dealing with large email databases."
    },
    "features": {
        "bot_user": {
            "display_name": "tomba",
            "always_online": false
        },
        "slash_commands": [
            {
                "command": "/author",
                "url": "https://yourdomain.com/author?slack=true",
                "description": "Instantly discover the email addresses of article authors.",
                "usage_hint": "https://clearbit.com/blog/company-name-to-domain-api",
                "should_escape": false
            },
            {
                "command": "/enrich",
                "url": "https://yourdomain.com/enrich?slack=true",
                "description": "Locate and include data in your emails.",
                "usage_hint": "m@wordpress.org",
                "should_escape": false
            },
            {
                "command": "/linkedin",
                "url": "https://yourdomain.com/linkedin?slack=true",
                "description": "Instantly discover email addresses from LinkedIn URLs.",
                "usage_hint": "https://www.linkedin.com/in/mattm",
                "should_escape": false
            },
            {
                "command": "/domain",
                "url": "https://yourdomain.com/search?slack=true",
                "description": "Instantly locate email addresses from any company name or website.",
                "usage_hint": "tomba.io",
                "should_escape": false
            },
            {
                "command": "/checker",
                "url": "https://yourdomain.com/verify?slack=true",
                "description": "Verify the deliverability of an email address.",
                "usage_hint": "m@wordpress.org",
                "should_escape": false
            }
        ]
    },
    "oauth_config": {
        "scopes": {
            "bot": ["commands", "chat:write", "chat:write.public"]
        }
    },
    "settings": {
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false
    }
}
```